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

أجهزة XR المشمولة

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

مزيد من المعلومات حول أنواع أجهزة XR →

مزيد من المعلومات حول أنواع أجهزة XR →

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

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

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

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

الوصول إلى جلسة من 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. */)
    }
}
Session.kt

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

انظر أيضًا

• التحقّق من إمكانات العرض المكاني
• الانتقال بين HSM وFSM
• إضافة بيئات مكانية إلى تطبيقك
• إضافة تصاميم ثلاثية الأبعاد إلى تطبيقك