建立影片播放器活動

活動收到 onCreate() 生命週期回呼方法時,應執行下列步驟:

  • 建立及初始化媒體工作階段
  • 設定媒體工作階段回呼
  • 將媒體工作階段的媒體按鈕接收器設為空值,這樣在無法顯示時,媒體按鈕事件就不會重新啟動播放器。這項設定只會影響 Android 5.0 (API 級別 21) 以上版本的裝置。
  • 建立及初始化媒體控制器

以下 onCreate() 程式碼示範這些步驟:

KotlinJava
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() 回呼時,應釋放並清理播放器。