המשתמש יכול לחוות את האפליקציה בשני מצבים: מרחב ביתי או מרחב מלא. במרחב הבית, משתמש יכול לבצע כמה משימות בו-זמנית כשהאפליקציה שלכם פועלת לצד אפליקציות אחרות. במרחב מלא, האפליקציה שלכם נמצאת במרכז, כשהיא מוקד חוויית המשתמש, עם גישה מלאה ליכולות המציאות המדומה של Android XR.
האפליקציה נפתחת במרחב הבית כברירת מחדל, אלא אם מציינים אחרת כמו שמתואר בקטע הצהרה על מצב ברירת המחדל להפעלה.
הוספת אפקטים מרחביים נתמכת רק במרחב מלא. האפליקציה יכולה לעבור למצב 'מרחב מלא' כדי לנצל את היכולות המרחביות והתלת-ממדיות. כשהאפליקציה נמצאת בפוקוס, אפשר לעבור בין המצבים האלה על ידי הקשה על המקש המתאים.
אפשר להשתמש ב-SpaceToggleButton כדי לעבור בין מרחב הבית למרחב מלא
כדי לעבור בין מרחב הבית למרחב המלא, משתמשים ב-composable SpaceToggleButton מהספרייה Material Design for XR.
זהו כפתור קומפזבילי שמותאם למצב המרחבי הנוכחי ועובר בין מצב 'תצוגה מורחבת' לבין מצב 'תצוגה מצומצמת'.
יצירת מעבר מותאם אישית בין המרחב הביתי למרחב המלא
אם אתם משתמשים בספריית Jetpack Compose for XR, אתם יכולים לבקש מרחב ביתי או מרחב מלא באמצעות הקומפוזיציה המקומית LocalSession.
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
אם אתם משתמשים בספריית Jetpack SceneCore, אתם יכולים לבקש את המרחב המתאים מ-Session. מידע נוסף זמין במאמר גישה לסשן מ-Jetpack SceneCore.
xrSession.scene.requestHomeSpace()
בשיעור Codelab בנושא יסודות 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" />