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.