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

מכשירי 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
}
Session.kt

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

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

כדי ליצור סשן, מעבירים פעילות למתודה create(), כמו בדוגמה הבאה:

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

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

למידע נוסף