סשן

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

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

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

import androidx.xr.compose.platform.LocalSession

class myActivity : Activity() {
   val xrSession = checkNotNull(LocalSession.current)
}

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

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

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

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

import androidx.xr.scenecore.Session

class myActivity : Activity() {
  val xrSession = Session.create(this)
}

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

למידע נוסף