適切なタイミングで PiP に入る

アプリは、次のような状況では PiP モードに移行しないでください。

• 動画が停止または一時停止している場合。
• 動画プレーヤーとは異なるアプリのページを表示している場合。

アプリが PiP モードに移行するタイミングを制御するには、動画プレーヤーの状態 を追跡する変数をmutableStateOf使用して追加します。

動画が再生されているかどうかに基づいて状態を切り替える

動画プレーヤーが再生されているかどうかに基づいて状態を切り替えるには、動画プレーヤーにリスナーを追加します。プレーヤー が再生されているかどうかに基づいて、状態変数の状態を切り替えます。

player.addListener(object : Player.Listener {
    override fun onIsPlayingChanged(isPlaying: Boolean) {
        shouldEnterPipMode = isPlaying
    }
})
PictureInPictureSnippets.kt

プレーヤーがリリースされたかどうかに基づいて状態を切り替える

プレーヤーがリリースされたら、状態変数を false に設定します。

fun releasePlayer() {
    shouldEnterPipMode = false
}
PictureInPictureSnippets.kt

状態を使用して PiP モードに移行するかどうかを定義する（Android 12 より前）

1. 12 より前のバージョンで PiP を追加する場合は DisposableEffect を使用するため、 rememberUpdatedState で新しい変数を作成する必要があります。newValue を状態変数として設定します。これにより、更新されたバージョンが DisposableEffect 内で使用されるようになります。

2. OnUserLeaveHintListener がトリガーされたときの動作を定義するラムダで、enterPictureInPictureMode() の呼び出しの周囲に状態変数を含む if ステートメントを追加します。

   val currentShouldEnterPipMode by rememberUpdatedState(newValue = shouldEnterPipMode)
   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O &&
       Build.VERSION.SDK_INT < Build.VERSION_CODES.S
   ) {
       val context = LocalContext.current
       DisposableEffect(context) {
           val onUserLeaveBehavior = Runnable {
               if (currentShouldEnterPipMode) {
                   context.findActivity()
                       .enterPictureInPictureMode(PictureInPictureParams.Builder().build())
               }
           }
           context.findActivity().addOnUserLeaveHintListener(
               onUserLeaveBehavior
           )
           onDispose {
               context.findActivity().removeOnUserLeaveHintListener(
                   onUserLeaveBehavior
               )
           }
       }
   } else {
       Log.i("PiP info", "API does not support PiP")
   }
   PictureInPictureSnippets.kt

状態を使用して PiP モードに移行するかどうかを定義する（Android 12 以降）

状態変数を setAutoEnterEnabled に渡して、アプリが適切なタイミングでのみ PiP モードに移行するようにします。

val pipModifier = modifier.onGloballyPositioned { layoutCoordinates ->
    val builder = PictureInPictureParams.Builder()

    // Add autoEnterEnabled for versions S and up
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        builder.setAutoEnterEnabled(shouldEnterPipMode)
    }
    context.findActivity().setPictureInPictureParams(builder.build())
}

VideoPlayer(pipModifier)
PictureInPictureSnippets.kt

setSourceRectHint を使用してスムーズなアニメーションを実現する

setSourceRectHint API を使用すると、PiP モードへの移行がスムーズなアニメーションになります。Android 12 以降では、PiP モードの終了もスムーズなアニメーションになります。 この API を PIP ビルダーに追加して、PIP へのトランジション後に表示される Activity の領域を示します。

1. 状態によってアプリが PiP モードに移行する必要があると定義されている場合にのみ、setSourceRectHint() を builder に追加します。これにより、アプリが PiP に移行する必要がない場合に sourceRect が計算されるのを防ぐことができます。
2. sourceRect 値を設定するには、修飾子の onGloballyPositioned 関数から提供される layoutCoordinates を使用します。
3. builder で setSourceRectHint() を呼び出し、sourceRect 変数を渡します。

val context = LocalContext.current

val pipModifier = modifier.onGloballyPositioned { layoutCoordinates ->
    val builder = PictureInPictureParams.Builder()
    if (shouldEnterPipMode) {
        val sourceRect = layoutCoordinates.boundsInWindow().toAndroidRectF().toRect()
        builder.setSourceRectHint(sourceRect)
    }

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        builder.setAutoEnterEnabled(shouldEnterPipMode)
    }
    context.findActivity().setPictureInPictureParams(builder.build())
}

VideoPlayer(pipModifier)
PictureInPictureSnippets.kt