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

أجهزة 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، عليك إنشاء جلسة.

لإنشاء جلسة، مرِّر نشاطًا إلى طريقة create() ، كما هو موضّح في المثال التالي:

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

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

انظر أيضًا