Creazione di un'attività video player

Quando l'attività riceve il metodo di callback del ciclo di vita onCreate(), deve eseguire i seguenti passaggi:

  • Crea e inizializza la sessione multimediale
  • Imposta il callback della sessione multimediale
  • Imposta il ricevitore del pulsante multimediale della sessione multimediale su null in modo che un evento del pulsante multimediale non riavvii il player quando non è visibile. Questo riguarda solo i dispositivi Android 5.0 (livello API 21) e versioni successive.
  • Creare e inizializzare il controller multimediale

Il codice onCreate() riportato di seguito mostra questi passaggi:

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);
}

Quando un'app viene chiusa, l'attività riceve i callback onPause() e onStop() in successione. Se il giocatore sta giocando, devi interrompere il gioco prima che l'attività scompaia. La scelta del callback da utilizzare dipende dalla versione di Android in uso.

In Android 6.0 (livello API 23) e versioni precedenti non è garantito quando viene chiamato onStop(); potrebbe essere chiamato 5 secondi dopo la scomparsa dell'attività. Di conseguenza, nelle versioni di Android precedenti alla 7.0, la riproduzione della tua app dovrebbe essere interrotta in onPause(). In Android 7.0 e versioni successive, il sistema chiama onStop() non appena l'attività non diventa visibile, quindi non è un problema.

In sintesi:

  • In Android 6.0 e versioni precedenti, interrompi il player nel callback onPause().
  • In Android 7.0 e versioni successive, interrompi il player nel callback onStop().

Quando l'attività riceve il callback onDestroy(), dovrebbe rilasciare e pulire il player.