À propos du mode Picture-in-picture (PIP)

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Le mode Picture-in-picture (PIP) est un type particulier de mode multifenêtre principalement utilisé pour la lecture vidéo. Elle permet à l'utilisateur de regarder une vidéo dans une petite fenêtre épinglée dans un coin de l'écran tout en naviguant entre les applis ou en parcourant le contenu de l'écran principal.

Le mode Picture-in-picture exploite les API multifenêtre disponibles dans Android 7.0 pour fournir la fenêtre de superposition vidéo épinglée. Pour ajouter le mode PiP à votre application, vous devez enregistrer votre activité, la passer en mode PiP si nécessaire et vous assurer que les éléments de l'interface utilisateur sont masqués et que la lecture vidéo se poursuit lorsque l'activité est en mode PiP.

Gérer votre UI en mode PiP

Lorsque vous accédez au mode PiP, l'UI complète de votre application s'affiche dans la fenêtre PiP, sauf si vous spécifiez l'apparence de votre UI en mode PiP et hors mode PiP.

Tout d'abord, vous devez savoir si votre application est en mode PiP ou non. Pour ce faire, vous pouvez utiliser OnPictureInPictureModeChangedProvider. Le code ci-dessous vous indique si votre application est en mode PiP.

@Composable
fun rememberIsInPipMode(): Boolean {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val activity = LocalContext.current.findActivity()
        var pipMode by remember { mutableStateOf(activity.isInPictureInPictureMode) }
        DisposableEffect(activity) {
            val observer = Consumer<PictureInPictureModeChangedInfo> { info ->
                pipMode = info.isInPictureInPictureMode
            }
            activity.addOnPictureInPictureModeChangedListener(
                observer
            )
            onDispose { activity.removeOnPictureInPictureModeChangedListener(observer) }
        }
        return pipMode
    } else {
        return false
    }
}
PictureInPictureSnippets.kt

Vous pouvez maintenant utiliser rememberIsInPipMode() pour activer ou désactiver les éléments d'interface utilisateur à afficher lorsque l'application passe en mode PiP:

val inPipMode = rememberIsInPipMode()

Column(modifier = modifier) {
    // This text will only show up when the app is not in PiP mode
    if (!inPipMode) {
        Text(
            text = "Picture in Picture",
        )
    }
    VideoPlayer()
}
PictureInPictureSnippets.kt