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

מכשירי XR רלוונטיים
ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים האלה.
מידע על סוגי מכשירי XR →
משקפי XR
משקפי AR חוטיים
מידע על סוגי מכשירי XR →

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

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

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

אפשר להשתמש בצירוף המקשים SpaceToggleButton כדי לעבור בין תצוגה מצומצמת לתצוגה מורחבת

כדי לעבור בין מרחב הבית למסך המלא, משתמשים בקוד SpaceToggleButton קומפזבילי מהספרייה Material Design for XR.

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

יצירת מעבר מותאם אישית בין המרחב הביתי למרחב המלא

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

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

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

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

ב-codelab Learn Android XR Fundamentals: Part 1 - Modes and Spatial Panels יש דוגמאות לשימוש בבקשות האלה כדי לעבור בין מצבים בלחיצה על לחצן. מומלץ גם לעיין בהנחיות העיצוב שלנו כדי לקבל מידע נוסף על מעבר ממרחב ביתי למרחב מלא, ואיך לבצע את המעבר בצורה הכי טובה.

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

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

למידע נוסף