建立影片播放器活動

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