מידע על התכונה 'תמונה בתוך תמונה' (PiP)

תמונה בתוך תמונה (PiP) היא סוג מיוחד של מצב ריבוי חלונות שמשמש בעיקר להפעלת סרטונים. באפליקציות עם התכונה הזו, המשתמשים יכולים לצפות בסרטונים בחלון קטן שמוצמד לפינה של המסך. כך הסרטון ממשיך לפעול גם כשהם עוברים בין אפליקציות או מעיינים בתוכן במסך הראשי.

התכונה 'תמונה בתוך תמונה' מסתמכת על ממשקי API של ריבוי חלונות שזמינים ב-Android 7.0 כדי לספק את חלון הווידאו הצף. כדי להוסיף PiP לאפליקציה, צריך לרשום את הפעילות, להעביר את הפעילות למצב PiP לפי הצורך ולוודא שרכיבי ממשק המשתמש מוסתרים והפעלת הסרטון נמשכת כשהפעילות במצב PiP.

使用 Jetpack 实现 PiP

使用 Jetpack 画中画库来实现画中画体验，因为它可以简化集成并减少常见的应用内问题。如需查看其使用示例，请参阅我们的平台示例应用。不过，如果您希望使用平台 API 实现 PiP，请参阅以下文档。

איך משתמשים בממשק המשתמש במצב PIP

כשנכנסים למצב תמונה בתוך תמונה, כל ממשק המשתמש של האפליקציה נכנס לחלון התמונה בתוך תמונה, אלא אם מציינים איך ממשק המשתמש צריך להיראות במצב תמונה בתוך תמונה ומחוצה לו.

קודם כול, אתם צריכים לדעת מתי האפליקציה שלכם במצב תמונה בתוך תמונה ומתי לא. כדי לעשות את זה, אפשר להשתמש בפקודה OnPictureInPictureModeChangedProvider. הקוד שבהמשך מראה אם האפליקציה פועלת במצב תמונה בתוך תמונה.

@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

עכשיו אפשר להשתמש ב-rememberIsInPipMode() כדי להחליף בין רכיבי ממשק המשתמש שיוצגו כשהאפליקציה תעבור למצב 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