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. */) }
כשהפעילות של סשן מסוים נמחקת, כל ממשק המשתמש המרחבי וכל התוכן התלת-ממדי שמשויכים לסשן הזה נמחקים, והסשן כבר לא תקף.
למידע נוסף
- בדיקת היכולות המרחביות
- מעבר בין HSM ל-FSM
- הוספת סביבות מרחביות לאפליקציה
- הוספת מודלים תלת-ממדיים לאפליקציה