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

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

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

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

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

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

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

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

لإنشاء جلسة، مرِّر [Context] إلى create() method. يمكن أن يكون هذا 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. */)
    }
}

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

انظر أيضًا