活動收到 onCreate()
生命週期回呼方法時,應執行下列步驟:
- 建立及初始化媒體工作階段
- 設定媒體工作階段回呼
- 將媒體工作階段的媒體按鈕接收器設為空值,這樣在無法顯示時,媒體按鈕事件就不會重新啟動播放器。這項設定只會影響 Android 5.0 (API 級別 21) 以上版本的裝置。
- 建立及初始化媒體控制器
以下 onCreate()
程式碼示範這些步驟:
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);
}
關閉應用程式時,活動會依序收到 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()
回呼時,應釋放並清理播放器。