מסכים גדולים במצב פתוח ומצבים ייחודיים במצב מקופל מאפשרים חוויות משתמש חדשות במכשירים מתקפלים. כדי שהאפליקציה תהיה מותאמת למצב קיפול ב-Jetpack Compose, צריך להשתמש בספרייה Compose Material 3 Adaptive, שמספקת ממשקי API לתכונות של חלונות במכשירים מתקפלים, כמו קיפולים, צירים ותנוחות של המכשיר. כשהאפליקציה מותאמת למסכים מתקפלים, היא יכולה להתאים את הפריסה שלה כדי להימנע מהצבת תוכן חשוב באזור הקיפולים או הצירים, ולהשתמש בקיפולים ובצירים כמפרידים טבעיים.
אם אתם יודעים אם מכשיר תומך בתצורות כמו "על משטח, מסך למעלה" או "ספר", אתם יכולים להחליט אם לתמוך בפריסות שונות או לספק תכונות ספציפיות.
פרטי החלון
ב-Jetpack Compose, משתמשים בפונקציה הקומפוזבילית collectFoldingFeaturesAsState() כדי לצפות במידע על קיפול החלון.
collectFoldingFeaturesAsState() אוסף את תכונות הקיפול של החלון הנוכחי מ-WindowInfoTracker ל-State של Compose שמכיל רשימה של אובייקטים מסוג FoldingFeature.
מכיוון שהפונקציה collectFoldingFeaturesAsState() מחזירה את הערך State של Compose, הפונקציות הניתנות לקישור יוצרות קומפוזיציה מחדש באופן אוטומטי בכל פעם שמצב הקיפול או התנוחה של המכשיר משתנים, בלי צורך בניהול ידני של מחזור החיים או באיסוף ערכי Flow:
@Composable
fun FoldAwareScreen() {
val foldingFeatures by collectFoldingFeaturesAsState()
// Access folding features for the current window.
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
// Adapt layout based on the fold feature.
}
}
תכונות של מסכים מתקפלים
רשימת הרכיבים של FoldingFeature שמוחזרים על ידי collectFoldingFeaturesAsState() (סוג משנה של DisplayFeature) מספקת מידע על מסכים מתקפלים, כולל המאפיינים הבאים:
state: מצב הקיפול של המכשיר,FLATאוHALF_OPENED
orientation: הכיוון של הקיפול או הציר,HORIZONTALאוVERTICAL
occlusionType: אם הקיפול או הציר מסתירים חלק מהמסך,NONEאוFULL
isSeparating: אם הקיפול או הציר יוצרים שני אזורי תצוגה לוגיים, true או false
במכשיר מתקפל שמוגדר כ-HALF_OPENED, הערך של isSeparating תמיד יהיה true כי המסך מחולק לשני אזורי תצוגה. בנוסף, הערך של isSeparating הוא תמיד True במכשיר עם מסך כפול כשהאפליקציה מוצגת בשני המסכים.
המאפיין FoldingFeature bounds (שעובר בירושה מ-DisplayFeature) מייצג את המלבן התוחם של תכונת קיפול, כמו קיפול או ציר.
אפשר להשתמש בגבולות כדי למקם רכיבים במסך ביחס לתכונה:
@Composable
fun FoldFeatureDemo() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
val isSeparating = foldFeature.isSeparating
val occlusionType = foldFeature.occlusionType
val bounds = foldFeature.bounds
// Use bounds and properties to position content.
}
}
מצב שולחני
בעזרת המידע שכלול באובייקט FoldingFeature, האפליקציה יכולה לתמוך בתנוחות כמו "על משטח, מסך למעלה", שבה הטלפון מונח על משטח, הציר במצב אופקי והמסך המתקפל פתוח למחצה.
במצב "על משטח, מסך למעלה", המשתמשים יכולים להפעיל את הטלפון בלי להחזיק אותו בידיים. מצב שולחני מתאים לצפייה במדיה, לצילום תמונות ולביצוע שיחות וידאו.
משתמשים ב-FoldingFeature.State וב-FoldingFeature.Orientation מ-collectFoldingFeaturesAsState() כדי לקבוע אם המכשיר נמצא במצב "על משטח, מסך למעלה":
@Composable
fun TabletopContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isTableTopPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.HORIZONTAL
if (isTableTopPosture) {
// Tabletop layout: separate content and controls across the fold.
} else {
// Standard layout.
}
}
לחלופין, אפשר לבדוק אם החלון נמצא במצב "על משטח, מסך למעלה" באמצעות בדיקת המאפיין Posture שמוחזר על ידי currentWindowAdaptiveInfoV2():
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val isTabletop = adaptiveInfo.windowPosture.isTabletop
אחרי שמוודאים שהמכשיר במצב מחשב נייד, מעדכנים את פריסת האפליקציה בהתאם. באפליקציות מדיה, בדרך כלל זה אומר שההפעלה צריכה להיות בחלק העליון של המסך, והלחצנים והתוכן הנוסף צריכים להיות מתחתיה, כדי לאפשר צפייה או האזנה ללא מגע.
דוגמאות
אפליקציית
MediaPlayerActivity: איך משתמשים ב-Media3 Exoplayer וב-WindowManager כדי ליצור נגן וידאו שמותאם למכשירים מתקפלים.התאמת תוכן מדיה לגורמי צורה שונים: איך מטפלים ב-window insets, בשינוי דינמי של גודל החלון ובהתאמת התוכן ב-Jetpack Compose עם Media3.
אופטימיזציה של אפליקציית המצלמה במכשירים מתקפלים באמצעות Jetpack WindowManager codelab: איך מטמיעים את מצב "על משטח, מסך למעלה" באפליקציות צילום. הציגו את תצוגת הצילום בחצי העליון של המסך (מעל הקו המפריד) ואת פקדי השליטה בחצי התחתון.
מצב ספר
תכונה ייחודית נוספת של מכשירים מתקפלים היא מצב ספר, שבו המכשיר פתוח למחצה והציר אנכי. מצב ספר מתאים לקריאת ספרים דיגיטליים. במצב ספר, פריסה של שני עמודים במסך גדול מתקפל נפתחת כמו ספר כרוך, ומאפשרת לכם ליהנות מחוויית קריאה של ספר אמיתי.
אפשר להשתמש בו גם לצילום תמונות ביחס גובה-רוחב שונה בלי להחזיק את המכשיר.
כדי להשתמש במצב ספר, צריך להשתמש באותן טכניקות שמשמשות למצב "על משטח, מסך למעלה". בודקים שהכיוון של תכונת הקיפול הוא אנכי ולא אופקי:
@Composable
fun BookContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isBookPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.VERTICAL
if (isBookPosture) {
// Book posture layout: two-page layout across the vertical fold.
} else {
// Standard single-page layout.
}
}
שינויים בגודל החלון
אזור התצוגה של האפליקציה יכול להשתנות כתוצאה משינוי בהגדרות המכשיר, למשל כשהמכשיר מקופל או פתוח, מסובב או משנים את הגודל שלו במצב ריבוי חלונות.
כדי לאחזר את סיווג גודל החלון הנוכחי ולהתאים אותו לשינויים בגודל ב-Jetpack Compose, משתמשים בפונקציה הקומפוזבילית currentWindowAdaptiveInfoV2() מספריית Compose Material 3 Adaptive. currentWindowAdaptiveInfoV2()
מחזיר מופע של WindowAdaptiveInfo שמספק את
WindowSizeClass של החלון הנוכחי (עם תמיכה בנקודות עצירה גדולות וגדולות מאוד כברירת מחדל), וגם את
windowPosture של המכשיר:
@Composable
fun AdaptiveApp() {
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val windowSizeClass = adaptiveInfo.windowSizeClass
when {
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_EXPANDED_LOWER_BOUND
) -> {
// Expanded layout
}
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_MEDIUM_LOWER_BOUND
) -> {
// Medium layout
}
else -> {
// Compact layout
}
}
}
מקורות מידע נוספים
למידע נוסף על פריסות שמותאמות למכשירים מתקפלים ועל מכשירים מתקפלים, עיינו במקורות המידע הבאים:
דוגמאות
- דוגמה ל-WindowManager של Jetpack: דוגמה לשימוש בספריית WindowManager של Jetpack
- Jetcaster: הטמעה של מצב "על משטח, מסך למעלה" באמצעות Compose
Codelabs
- תמיכה במכשירים מתקפלים ובמכשירים עם שני מסכים באמצעות Jetpack WindowManager
- אופטימיזציה של אפליקציית המצלמה במכשירים מתקפלים באמצעות Jetpack WindowManager