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

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

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

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

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

אם אתם משתמשים בספרייה של Jetpack Compose for XR, תוכלו לבקש מרחב בית או מרחב מלא באמצעות ה-composition local של LocalSpatialConfiguration.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()

אם אתם משתמשים בספריית Jetpack SceneCore, תוכלו לבקש את המרחב המתאים מ-Session.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

בקודלאב לימוד העקרונות הבסיסיים של Android XR: חלק 1 – מצבים וחלוניות מרחביות תוכלו למצוא דוגמאות לשימוש בבקשות האלה כדי לעבור בין מצבים בלחיצה על לחצן. מומלץ גם לעיין בהנחיות העיצוב שלנו כדי לקבל מידע נוסף על המעבר ממסך הבית למסך מלא, ועל הדרך הטובה ביותר לבצע את המעבר.

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

לחלופין, אפשר להוסיף את השורות הבאות לקובץ המניפסט של 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" />

למידע נוסף