الوصول إلى جلسة لإنشاء عناصر وواجهات مستخدم مجسّمة

أجهزة XR المشمولة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.
مزيد من المعلومات حول أنواع أجهزة XR →
سماعات الرأس بنظام الواقع الممتد
نظارات سلكية بنظام الواقع الممتد
مزيد من المعلومات حول أنواع أجهزة XR →

يوفر Session الواجهة الأساسية للوظائف المكانية في تطبيقك، ويجب أن ينشئ كل Activity مكاني مثيلاً من Session ويحتفظ به. بعد أن ينشئ تطبيقك جلسة، يمكنه استخدام واجهات Session لإنشاء عناصر محتوى مكاني، مثل اللوحات أو التصاميم الثلاثية الأبعاد، بالإضافة إلى ضبط بيئة مكانية وتحديد موضع المستخدم وتثبيت المحتوى في العالم الحقيقي.

الوصول إلى جلسة من Jetpack Compose for XR

عند استخدام Jetpack Compose للواقع الممتد، يتم إنشاء الجلسة لك ويمكن الوصول إليها باستخدام LocalSession.current. انظر المثال التالي:

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

الوصول إلى جلسة من Jetpack XR Runtime

إذا كنت تنشئ عناصر مجسّمة من مكتبة Jetpack SceneCore، عليك إنشاء جلسة.

لإنشاء جلسة، مرِّر Context إلى طريقة create(). يمكن أن يكون هذا Context Activity على أجهزة XR غامرة أو أجهزة جوّالة، أو سياقًا معروضًا.

يمكن أن يكون إنشاء جلسة ARCore مهمة مكلفة، ويجب معالجتها في الخلفية، كما هو موضّح في المثال التالي:

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

عند إيقاف نشاط جلسة، يتم إيقاف جميع عناصر واجهة المستخدم المكانية والمحتوى الثلاثي الأبعاد المرتبطين بهذه الجلسة، وتصبح الجلسة غير صالحة.

انظر أيضًا