הוספת תת-מרחב לאפליקציה

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

אפשר להשתמש ב-@SubspaceComposable כמו Volume ו-SpatialPanel כדי למקם מודלים תלת-ממדיים. חלק מרכיבי ה-XR, כמו רכיבי Orbiter או רכיבי SpatialDialog, הם רכיבים סטנדרטיים ל-2D שאפשר להשתמש בהם בכל מקום בהיררכיית ממשק המשתמש הדו-מימדי, אבל צריך להפעיל רכיבי SubspaceComposable במרחב המשנה של האפליקציה. כדי לעשות זאת, משתמשים ב-composable‏ Subspace.

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

מידע על היררכיות של מרחבים משניים

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

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

למרחבים משניים בתצוגת עץ יש שני הבדלים עיקריים מ-Subspace ברמה העליונה:

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

ההתנהגויות האלה של תת-מרחב עץ מאפשרות יכולות כמו:

• העברת הצאצא עם הישות ההורה
• שינוי המיקום של הילד או הילדה באמצעות שינוי המיקום SubspaceModifier
• הצגת אובייקט תלת-ממדי שמרחף מעל ממשק המשתמש הדו-ממדי ומתאים לגובה ולרוחב של המרחב המתאים בפריסה הדו-ממדית

הוספת תת-מרחב לאפליקציה

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

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    enableEdgeToEdge()
    setContent {
        // This is a top-level subspace
        Subspace {
            SpatialPanel {
                MyComposable()
            }
        }
    }
}
@Composable
private fun MyComposable() {
    Row {
        PrimaryPane()
        SecondaryPane()
    }
}
@Composable
private fun PrimaryPane() {
      ...
    // This is a nested subspace, because PrimaryPane is in a SpatialPanel
    // and that SpatialPanel is in a top-level Subspace
    Subspace {
        ObjectInAVolume(show3DObject)
    }
      ...
}