動画プレーヤー アクティビティの作成

アクティビティが 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);
}

アプリが閉じられると、アクティビティは 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() コールバックを受け取ると、プレーヤーを解放してクリーンアップする必要があります。