Informacje o obrazie w obrazie (PiP)

Obraz w obrazie (PiP) to specjalny tryb wielu okien, który jest najczęściej używany do odtwarzania filmów. Umożliwia użytkownikowi oglądanie filmu w małym oknie przypiętym do rogu ekranu, a jednocześnie przełączanie się między aplikacjami lub przeglądanie treści na głównym ekranie.

Tryb PiP korzysta z interfejsów API wielookienkowych udostępnionych w Androidzie 7.0, aby wyświetlać przypięte okno nakładki wideo. Aby dodać tryb PiP do aplikacji, musisz zarejestrować aktywność, w razie potrzeby przełączyć ją w tryb PiP oraz ukryć elementy interfejsu i zapewnić, że odtwarzanie wideo będzie kontynuowane, gdy aktywność jest w trybie PiP.

Wdrażanie obrazu w obrazie za pomocą Jetpack

Użyj biblioteki Jetpack Picture-in-Picture, aby wdrożyć funkcję obrazu w obrazie. Ułatwia ona integrację i ogranicza typowe problemy w aplikacji. Przykład użycia znajdziesz w naszej przykładowej aplikacji na platformę. Jeśli jednak wolisz zaimplementować tryb obrazu w obrazie za pomocą interfejsów API platformy, zapoznaj się z tą dokumentacją.

Obsługa interfejsu w trybie PiP

Gdy przejdziesz do trybu PiP, cały interfejs aplikacji zostanie przeniesiony do okna PiP, chyba że określisz, jak interfejs ma wyglądać w trybie PiP i poza nim.

Najpierw musisz wiedzieć, kiedy aplikacja jest w trybie PiP, a kiedy nie. Możesz to zrobić za pomocą funkcji OnPictureInPictureModeChangedProvider. Poniższy kod sprawdza, czy aplikacja jest w trybie 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

Teraz możesz użyć funkcji rememberIsInPipMode(), aby przełączać elementy interfejsu, które mają być wyświetlane, gdy aplikacja przechodzi w tryb 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