הפעלת מודעות לקיפול באפליקציה

מסכים גדולים במצב פתוח ומצבים ייחודיים במצב מקופל מאפשרים חוויות משתמש חדשות במכשירים מתקפלים. כדי שהאפליקציה תהיה מותאמת למצב קיפול ב-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, האפליקציה יכולה לתמוך בתנוחות כמו "על משטח, מסך למעלה", שבה הטלפון מונח על משטח, הציר במצב אופקי והמסך המתקפל פתוח למחצה.

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

אפליקציה של נגן וידאו במצב מחשב נייד, שבה הסרטון מופעל בחלק האנכי העליון של המסך ורכיבי ה-UI להפעלה נמצאים בחלק האופקי התחתון.
איור 1. אפליקציה של נגן וידאו במצב מחשב נייד – הסרטון מוצג בחלק האנכי של המסך, ורכיבי ה-UI להפעלה מוצגים בחלק האופקי.

משתמשים ב-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

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

דוגמאות

מצב ספר

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

אפשר להשתמש בו גם לצילום תמונות ביחס גובה-רוחב שונה בלי להחזיק את המכשיר.

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

@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