الجلسة

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

الوصول إلى جلسة من Jetpack Compose لأجهزة الواقع المعزّز

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

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

الوصول إلى Session من Jetpack SceneCore

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

لا يمكن إنشاء جلسة إلا على جهاز Android XR. سيؤدي محاولة إنشاء جلسة على جهاز غير متوافق إلى تعذُّر إكمال العملية. ل إنشاء جلسة، عليك تمرير نشاط إلى طريقة create()، كما هو موضّح في المثال التالي.

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

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

انظر أيضًا