מעבר מתצוגה מצומצמת לתצוגה מורחבת

משתמשים יכולים להשתמש באפליקציה בשני מצבים: Home Space או Full Space. במרחב הבית, המשתמשים יכולים לבצע כמה משימות בו-זמנית, כשהאפליקציה שלכם פועלת לצד אפליקציות אחרות. במצב Full Space, האפליקציה שלכם נמצאת במרכז הבמה ומוקד חוויית המשתמש, עם גישה מלאה ליכולות ההתמקדות של Android XR.

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

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

מעבר בין מצב 'מרחב בית' למצב 'מרחב מלא'

כדי לעבור בין מצב 'מרחב בית' למצב 'מרחב מלא', צריך לבקש את מצב הפעולה מSession. כפי שמוצג בדוגמה הבאה, אפשר להשתמש בבקשות האלה כדי שהמשתמשים יוכלו לעבור בין המצבים בלחיצה על לחצן.

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

במדריך לעיצוב מוסבר בהרחבה על המעבר ממצב 'מרחב משותף' למצב 'מרחב משותף מלא', ועל הדרך הטובה ביותר לבצע את המעבר.

הצהרת מצב ברירת המחדל להפעלה

כדי לבחור אם האפליקציה תופעל במרחב הבית או במרחב המלא, מוסיפים את השורות הבאות לקובץ המניפסט של Android:

// Launch in Full Space:
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />

// Or, launch in Home Space:
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_HOME_SPACE_MANAGED" />

למידע נוסף