构建视频播放器 activity

如果 Activity 收到 onCreate() 生命周期回调方法，则应执行以下步骤：

• 创建并初始化媒体会话
• 设置媒体会话回调
• 将媒体会话的媒体按钮接收器设置为 Null，以使媒体按钮事件在播放器不可见时不会重新启动播放器。这只会影响 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);
}

应用关闭后，Activity 会相继收到 onPause() 和 onStop() 回调。如果播放器处于播放状态，您必须在其 Activity 消失之前将其停止。具体选择使用哪一个回调，取决于您运行的 Android 版本。

在 Android 6.0（API 级别 23）及更早版本中，无法保证何时调用 onStop()；可能会在您的 Activity 消失 5 秒后调用。因此，在 7.0 版以前的 Android 版本中，您的应用应在 onPause() 中停止播放。在 Android 7.0 及更高版本中，系统会在 Activity 变得不可见后立即调用 onStop()，因此这不是问题。

总结：

• 在 Android 6.0 及更低版本中，在 onPause() 回调中停止播放器。
• 在 Android 7.0 及更高版本中，在 onStop() 回调中停止播放器。

当 Activity 收到 onDestroy() 回调后，应释放并清理您的播放器。