الجلسة

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

الوصول إلى جلسة من 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
        // ...
    }
    is SessionCreatePermissionsNotGranted ->
        TODO(/* The required permissions in result.permissions have not been granted. */)
}
Session.kt

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

انظر أيضًا