アクティビティで onCreate()
ライフサイクル コールバック メソッドを受信したら、以下の手順を行います。
- メディア セッションを作成して初期化します。
- メディア セッション コールバックを設定します。
- メディア セッションのメディアボタン レシーバを null に設定して、プレーヤーが表示されていないときは、メディアボタン イベントによりプレーヤーが再起動されないようにします。これは、Android 5.0(API レベル 21)以降のデバイスにのみ影響します。
- メディア コントローラを作成して初期化します。
次の onCreate()
コードは、この手順を示しています。
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)
}
}
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()
コールバックを受信したら、プレーヤーを解放してクリーンアップするようにします。