جلسه

Session رابط اصلی را برای عملکرد فضایی برای برنامه فراهم می کند. هر فعالیت فضایی باید یک نمونه از Session ایجاد کرده و نگه دارد. پس از ایجاد، برنامه می‌تواند از رابط‌های Session برای ایجاد موجودیت‌های محتوای فضایی مانند پانل‌ها یا مدل‌های سه‌بعدی، و همچنین تنظیم یک محیط فضایی ، شناسایی موقعیت کاربر و لنگر دادن محتوا به دنیای واقعی استفاده کند.

دسترسی به جلسه از Jetpack Compose برای XR

هنگام استفاده از Jetpack Compose برای 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)
}

هنگامی که فعالیت یک جلسه از بین می رود، تمام رابط کاربری فضایی و محتوای سه بعدی مرتبط با آن جلسه از بین می رود و جلسه دیگر معتبر نیست.

همچنین ببینید