构建视频播放器 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() 回调后,应释放并清理您的播放器。