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

أجهزة 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. */)
    }
}

يمكن أن تستخدم الدالة create() مَعلمة LifecycleOwner اختيارية، ما يسمح بإدارة مراحل نشاط الجلسة من خلال LifecycleOwner مختلفة. يجب أن تبدأ LifecycleOwner مراحل نشاطها وتنتهي ضمن نطاق السياق المقدَّم، وإلا قد تكون Session عرضة للتسريبات.

انظر أيضًا