סשן

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

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

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

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

גישה לסשן מ-Jetpack SceneCore

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

אפשר ליצור סשן רק במכשיר Android XR. ניסיון ליצור סשן במכשיר לא תואם יביא לתוצאה של כשל. כדי ליצור סשן, מעבירים פעילות לשיטה create, כפי שמתואר בדוגמה הבאה.

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    is SessionCreatePermissionsNotGranted ->
        TODO(/* The required permissions in result.permissions have not been granted. */)
}

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

למידע נוסף