建立影片播放器活動

活動收到 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() 回呼時，應釋放並清理播放器。