גישה לסשן ליצירת ממשק משתמש ויישויות מרחביות

מכשירי XR רלוונטיים

ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים הבאים.

מידע ולמידה על סוגי מכשירי XR ←

מידע ולמידה על סוגי מכשירי XR ←

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

גישה לסשן מ-Jetpack Compose for XR

כשמשתמשים ב-Jetpack Compose for XR, הסשן נוצר בשבילכם ואפשר לגשת אליו באמצעות LocalSession.current. מקרה לדוגמה:

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}
Session.kt

גישה לסשן מ-Jetpack XR Runtime

אם אתם יוצרים ישויות מרחביות מספריית Jetpack SceneCore, תצטרכו ליצור סשן.

כדי ליצור סשן, מעבירים את Context ל-method‏ create(). ה-Context הזה יכול להיות Activity במכשירי XR עם חוויה סוחפת או במכשירים ניידים, או הקשר מוקרן במשקפיים חכמים.

יצירת סשן ARCore יכולה להיות משימה יקרה, וצריך לעבד אותה ברקע, כמו בדוגמה הבאה:

lifecycleScope.launch {
    when (val result = Session.create(context)) {
        is SessionCreateSuccess -> {
            val xrSession = result.session
            // ...
        }
        else ->
            TODO(/* A different unhandled exception was thrown. */)
    }
}
Session.kt

הפונקציה create() יכולה להשתמש בפרמטר האופציונלי LifecycleOwner, שמאפשר לנהל את מחזור החיים של הסשן באמצעות LifecycleOwner אחר. מחזור החיים של LifecycleOwner חייב להתחיל ולהסתיים בתוך ההקשר שסופק, אחרת יכולות להיות דליפות ב-Session.

עוד באותו הקשר

• בדיקת היכולות המרחביות
• מעבר בין HSM ל-FSM
• הוספת סביבות מרחביות לאפליקציה
• הוספת מודלים תלת-ממדיים לאפליקציה