Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る

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

アクティビティで 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 秒後に呼び出される可能性もあります。そのため、7.0 より前のバージョンの Android では、アプリでの再生の停止は onPause() で行うようにします。Android 7.0 以降では、アクティビティが表示されなくなるとすぐに onStop() が呼び出されるため、この問題はありません。

以下にまとめます。

  • Android バージョン 6.0 以前では、onPause() コールバックでプレーヤーを停止します。
  • Android バージョン 7.0 以降では、onStop() コールバックでプレーヤーを停止します。

アクティビティで onDestroy() コールバックを受信したら、プレーヤーを解放してクリーンアップするようにします。