دسترسی به جلسه‌ای برای ایجاد واسط کاربر و نهادهای فضایی

دستگاه‌های XR قابل‌اعمال
این راهنمایی به شما کمک می‌کند برای این نوع دستگاه‌های واقعیت گسترده تجربه بسازید.
آشنایی با انواع دستگاه‌های XR →
هدست‌های واقعیت گسترده
عینک واقعیت گسترده سیمی
آشنایی با انواع دستگاه‌های XR →

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

دسترسی به جلسه از Jetpack Compose برای واقعیت گسترده

هنگام استفاده از Jetpack Compose برای XR، جلسه برای شما ایجاد می‌شود و می‌توانید بااستفاده از LocalSession.current به آن دسترسی پیدا کنید. به مثال زیر توجه کنید:

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

دسترسی به جلسه از «زمان اجرای Jetpack XR»

اگر درحال ایجاد نهادهای فضایی‌شده از کتابخانه Jetpack SceneCore هستید، باید جلسه ایجاد کنید.

برای ایجاد جلسه، Context را به متد create() ارسال کنید. این Context می‌تواند Activity در دستگاه‌های «واقعیت گسترده فراگیر» یا دستگاه‌های همراه، یا زمینه پیش‌بینی‌شده باشد.

ایجاد جلسه ARCore می‌تواند کار پرهزینه‌ای باشد و باید در پس‌زمینه پردازش شود، همان‌طور که در مثال زیر نشان داده شده است:

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

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

همچنین مراجعه کنید به