إضافة إجراءات عن بُعد إلى وضع "صورة في صورة"

إذا أردت إضافة عناصر تحكّم (تشغيل، إيقاف مؤقت، وما إلى ذلك) إلى نافذة "نافذة ضمن النافذة"، أنشئ RemoteAction لكل عنصر تحكّم تريد إضافته.

  1. أضِف ثوابت لعناصر التحكّم في البث: 
    // Constant for broadcast receiver
const val ACTION_BROADCAST_CONTROL = "broadcast_control"

// Intent extras for broadcast controls from Picture-in-Picture mode.
const val EXTRA_CONTROL_TYPE = "control_type"
const val EXTRA_CONTROL_PLAY = 1
const val EXTRA_CONTROL_PAUSE = 2
  2. أنشئ قائمة RemoteActions لعناصر التحكّم في نافذة "نافذة ضمن النافذة".
  3. بعد ذلك، أضِف BroadcastReceiver واستبدِل onReceive() لضبط إجراءات كل زر. استخدِم DisposableEffect لتسجيل المستلِم والإجراءات عن بُعد. عند إيقاف المشغّل، عليك إلغاء تسجيل أداة الاستقبال. 
    @RequiresApi(Build.VERSION_CODES.O)
@Composable
fun PlayerBroadcastReceiver(player: Player?) {
    val isInPipMode = rememberIsInPipMode()
    if (!isInPipMode || player == null) {
        // Broadcast receiver is only used if app is in PiP mode and player is non null
        return
    }
    val context = LocalContext.current

    DisposableEffect(player) {
        val broadcastReceiver: BroadcastReceiver = object : BroadcastReceiver() {
            override fun onReceive(context: Context?, intent: Intent?) {
                if ((intent == null) || (intent.action != ACTION_BROADCAST_CONTROL)) {
                    return
                }

                when (intent.getIntExtra(EXTRA_CONTROL_TYPE, 0)) {
                    EXTRA_CONTROL_PAUSE -> player.pause()
                    EXTRA_CONTROL_PLAY -> player.play()
                }
            }
        }
        ContextCompat.registerReceiver(
            context,
            broadcastReceiver,
            IntentFilter(ACTION_BROADCAST_CONTROL),
            ContextCompat.RECEIVER_NOT_EXPORTED
        )
        onDispose {
            context.unregisterReceiver(broadcastReceiver)
        }
    }
}
  4. مرِّر قائمة بالإجراءات عن بُعد إلى PictureInPictureParams.Builder: 
    val context = LocalContext.current

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

    if (shouldEnterPipMode && player != null && player.videoSize != VideoSize.UNKNOWN) {
        val sourceRect = layoutCoordinates.boundsInWindow().toAndroidRectF().toRect()
        builder.setSourceRectHint(sourceRect)
        builder.setAspectRatio(
            Rational(player.videoSize.width, player.videoSize.height)
        )
    }

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

الخطوات التالية

السابق
إضافة "نافذة ضمن النافذة" (PIP) من خلال زرّ
التالي
استخدام مكتبة "نافذة ضمن النافذة" في Jetpack