Informazioni su Picture in picture (PiP)

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

La modalità Picture in picture (PIP) è un tipo speciale di modalità multi-finestra utilizzata principalmente per la riproduzione di video. Consente all'utente di guardare un video in una piccola finestra bloccata in un angolo dello schermo mentre naviga tra le app o sfoglia i contenuti nella schermata principale.

La modalità PIP sfrutta le API multi-finestra rese disponibili in Android 7.0 per fornire la finestra di overlay del video bloccata. Per aggiungere la modalità PiP alla tua app, devi registrare la tua attività, impostarla in modalità PiP in base alle esigenze e assicurarti che gli elementi dell'interfaccia utente siano nascosti e che la riproduzione del video continui quando l'attività è in modalità PiP.

Gestire l'interfaccia utente in modalità PiP

Quando entri in modalità PiP, l'intera UI dell'app viene visualizzata nella finestra PiP, a meno che non specifichi come deve apparire l'UI in modalità PiP e fuori.

Innanzitutto, devi sapere se la tua app è in modalità PiP o meno. Per farlo, puoi utilizzare OnPictureInPictureModeChangedProvider. Il codice riportato di seguito indica se la tua app è in modalità 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

Ora puoi usare rememberIsInPipMode() per attivare/disattivare gli elementi dell'interfaccia utente da mostrare quando l'app entra in modalità 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