活動收到 onCreate()
生命週期回呼方法時,應執行下列步驟:
- 建立並初始化媒體工作階段
- 設定媒體工作階段回呼
- 將媒體工作階段的媒體按鈕接收器設為空值,這樣一來,媒體按鈕事件在未顯示時就不會重新啟動播放器。這個問題只會影響 Android 5.0 (API 級別 21) 以上版本的裝置。
- 建立並初始化媒體控制器
下列 onCreate()
程式碼示範了這些步驟:
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); }
應用程式關閉後,活動會連續收到 onPause()
和 onStop()
回呼。如果玩家正在玩遊戲,你必須先停止播放,系統才會停止活動。請根據您使用的 Android 版本,選擇要使用的回呼。
在 Android 6.0 (API 級別 23) 以下版本中,系統無法保證呼叫 onStop()
的時機;在活動消失後,它可能會呼叫 5 秒。因此,在 Android 7.0 以下版本中,您的應用程式應在 onPause()
中停止播放。在 Android 7.0 以上版本中,當活動看不到時,系統會立即呼叫 onStop()
,因此這並非問題。
總結:
- 如果是 Android 6.0 以下版本,請在
onPause()
回呼中停止播放器。 - 如果是 Android 7.0 以上版本,請在
onStop()
回呼中停止播放器。
活動收到 onDestroy()
回呼時,應釋放並清理播放器。