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:
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)
}
}
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.