Videoplayer-Aktivität erstellen

Wenn die Aktivität die Lebenszyklus-Callback-Methode onCreate() empfängt, sollte sie die folgenden Schritte ausführen:

  • Media Session erstellen und initialisieren
  • Callback für die Mediensitzung festlegen
  • Setze den Empfänger der Medienschaltfläche der Mediensitzung auf „null“, damit ein Ereignis der Medienschaltfläche den Player nicht neu startet, wenn er nicht sichtbar ist. Dies betrifft nur Geräte mit Android 5.0 (API-Level 21) und höher.
  • MediaController erstellen und initialisieren

Der folgende onCreate()-Code veranschaulicht diese Schritte:

Kotlin

private lateinit var mediaSession: MediaSessionCompat

public override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Create a MediaSessionCompat
    mediaSession = MediaSessionCompat(this, LOG_TAG).apply {

        // Enable callbacks from MediaButtons and TransportControls
        setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS or
                MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS)

        // Do not let MediaButtons restart the player when the app is not visible
        setMediaButtonReceiver(null)

        // Set an initial PlaybackState with ACTION_PLAY, so media buttons can start the player
        val stateBuilder = PlaybackStateCompat.Builder()
                .setActions(PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PLAY_PAUSE)
        setPlaybackState(stateBuilder.build())

        // MySessionCallback has methods that handle callbacks from a media controller
        setCallback(MySessionCallback())
    }

    // Create a MediaControllerCompat
    MediaControllerCompat(this, mediaSession).also { mediaController ->
        MediaControllerCompat.setMediaController(this, mediaController)
    }
}

Java

MediaSessionCompat mediaSession;
PlaybackStateCompat.Builder stateBuilder;

@Override
public void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  // Create a MediaSessionCompat
  mediaSession = new MediaSessionCompat(this, LOG_TAG);

  // Enable callbacks from MediaButtons and TransportControls
  mediaSession.setFlags(
    MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS |
    MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);

  // Do not let MediaButtons restart the player when the app is not visible
  mediaSession.setMediaButtonReceiver(null);

  // Set an initial PlaybackState with ACTION_PLAY, so media buttons can start the player
  stateBuilder = new PlaybackStateCompat.Builder()
                .setActions(
                    PlaybackStateCompat.ACTION_PLAY |
                    PlaybackStateCompat.ACTION_PLAY_PAUSE);
  mediaSession.setState(stateBuilder.build());

  // MySessionCallback has methods that handle callbacks from a media controller
  mediaSession.setCallback(new MySessionCallback());

  // Create a MediaControllerCompat
  MediaControllerCompat mediaController =
    new MediaControllerCompat(this, mediaSession);

  MediaControllerCompat.setMediaController(this, mediaController);
}

Wenn eine App geschlossen wird, erhält die Aktivität nacheinander die Callbacks onPause() und onStop(). Wenn der Player gerade etwas wiedergibt, musst du die Wiedergabe beenden, bevor die Aktivität verschwindet. Welcher Callback verwendet werden soll, hängt von der Android-Version ab, die du verwendest.

In Android 6.0 (API-Level 23) und niedriger gibt es keine Garantie dafür, wann onStop() aufgerufen wird. Es könnte 5 Sekunden nach dem Verschwinden der Aktivität aufgerufen werden. In Android-Versionen vor 7.0 sollte die Wiedergabe in deiner App daher in onPause() beendet werden. In Android 7.0 und höher ruft das System onStop() auf, sobald die Aktivität nicht mehr sichtbar ist. Das ist also kein Problem.

Zusammenfassung:

  • In Android-Version 6.0 und niedriger wird der Player im Callback onPause() gestoppt.
  • Beenden Sie den Player unter Android 7.0 und höher im Callback onStop().

Wenn die Aktivität den onDestroy()-Callback empfängt, sollte sie den Player freigeben und bereinigen.