Karte „Now Playing“ anzeigen

TV-Apps, die Audio wiedergeben, k�nnen dies auch weiterhin tun, wenn der Nutzer zum Startbildschirm zur�ckkehrt oder zu einer anderen App wechselt. Dazu muss in der App eine Now Playing-Karte im Zuhause angezeigt werden. Bildschirm. Auf dieser Karte sehen Nutzer, woher das Audio stammt, und k�nnen dann zu deiner App zur�ckkehren die Medienwiedergabe zu steuern.

Wenn ein aktiver Nutzer MediaSession ist dargestellt wird, wird im Android-Framework auf dem Startbildschirm die Karte Now Playing angezeigt. Die Karte enth�lt Medienmetadaten wie Albumcover, Titel und App-Symbol. Wenn der Nutzer die Karte ausw�hlt, �ffnet das System die App.

Now Playing-Karte

Legen Sie nach der Implementierung einer Mediensitzung aktivieren und den Audiofokus anfordern, wird die Karte L�uft gerade angezeigt.

Hinweis:Die Karte L�uft gerade wird nur bei Medieninhalten mit der FLAG_HANDLES_TRANSPORT_CONTROLS gesetzt. Dieses Flag wird auf API-Level 26 eingestellt. Auf �lteren Ger�ten kann dieses Flag jedoch aus Gr�nden der Abw�rtskompatibilit�t weiterhin erforderlich sein.

Die Karte wird vom Launcher entfernt, wenn setActive(false) deaktiviert die Mediensitzung oder wenn eine andere App die Medienwiedergabe startet. Wenn die Wiedergabe vollst�ndig angehalten und es sind keine aktiven Medien vorhanden, deaktivieren Sie die Mediensitzung sofort. Wenn die Wiedergabe pausiert ist, deaktivieren Sie die Mediensitzung nach einer Verz�gerung. normalerweise zwischen 5 und 30 Minuten.

Karte aktualisieren

Immer wenn deine App den Wiedergabestatus in MediaSession aktualisiert, wird das Ereignis Die Karte Now Playing wird aktualisiert und zeigt den Status des aktuellen Mediums an. Informationen dazu finden Sie unter Aktualisiere den Wiedergabestatus.

Ebenso kann Ihre App die MediaMetadata zum Bereitstellen Informationen zum aktuellen Medium auf der Karte L�uft gerade, z. B. Titel, Untertitel, und verschiedene Symbole. Informationen dazu finden Sie unter Aktualisiere die Medienmetadaten.

Auf Nutzeraktion reagieren

Wenn der Nutzer die Karte Läuft gerade auswählt, öffnet das System die App, zu der das Gerät gehört. Sitzung. Wenn Ihre App eine PendingIntent bis setSessionActivity(), startet das System die von Ihnen angegebene Aktivität, wie im folgenden Code-Snippet gezeigt. Falls nicht, wird der Standard-System-Intent geöffnet. Die angegebene Aktivität muss über Steuerelemente für die Wiedergabe verfügen, die damit Nutzer die Wiedergabe pausieren oder beenden können.

val pi: PendingIntent = Intent(context, MyActivity::class.java).let { intent ->
    PendingIntent.getActivity(
            context, 99 /*request code*/,
            intent,
            PendingIntent.FLAG_UPDATE_CURRENT
    )
}
session.setSessionActivity(pi)

Intent intent = new Intent(context, MyActivity.class);
PendingIntent pi = PendingIntent.getActivity(context, 99 /*request code*/,
        intent, PendingIntent.FLAG_UPDATE_CURRENT);
session.setSessionActivity(pi);

Zulässige Anwendungsfälle

Die Karte Now Playing sollte nur verwendet werden, wenn der Nutzer erwartet, dass die Audiowiedergabe fortgesetzt wird. die beim Verlassen der App im Hintergrund wiedergegeben werden. Die Videowiedergabe oder der Ton eines Spiels sollten immer Die Funktion wird pausiert, es sei denn, deine App lässt sich einbinden und unterstützt die Funktion „Bild im Bild“.