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

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

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

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

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

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

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

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

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

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

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

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

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