Como criar uma atividade de um player de vídeo

Quando a atividade recebe o método de callback do ciclo de vida onCreate(), ela precisa realizar estas etapas:

  • Crie e inicialize a sessão de mídia
  • Defina o callback da sessão de mídia
  • Defina o receptor do botão de mídia da sessão de mídia como nulo para que um evento de botão de mídia não reinicie o player quando ele não estiver visível. Isso só afeta dispositivos com o Android 5.0 (nível 21 da API) e versões mais recentes.
  • Crie e inicialize o controlador de mídia

O código onCreate() a seguir demonstra essas etapas:

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 um app é fechado, a atividade recebe os callbacks onPause() e onStop() em sequência. Se o player estiver em reprodução, interrompa-o antes que a atividade dele seja encerrada. A escolha do callback depende da versão do Android que você está usando.

No Android 6.0 (nível 23 da API) e versões anteriores, não há garantia de quando onStop() será chamado. Ele pode ser chamado cinco segundos depois que a atividade desaparecer. Portanto, em versões do Android anteriores à 7.0, o app precisa interromper a reprodução em onPause(). No Android 7.0 e versões mais recentes, o sistema chama onStop() assim que a atividade deixa de ficar visível, então isso não é um problema.

Para resumir:

  • No Android 6.0 e versões anteriores, interrompa o player no callback onPause().
  • No Android 7.0 e versões mais recentes, interrompa o player no callback onStop().

Quando a atividade recebe o callback onDestroy(), ela precisa liberar e limpar o player.