الجلسة

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

الوصول إلى جلسة من Jetpack Compose لتجربة الواقع المعزّز

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

import androidx.xr.compose.platform.LocalSession

class myActivity : Activity() {
   val xrSession = checkNotNull(LocalSession.current)
}

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

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

لا يمكن إنشاء جلسة إلا على جهاز Android XR. في الوقت الحالي، إذا أنشأت Session وحاولت استخدامه على جهاز غير Android XR، ستظهر لك NullPointerException.

يمكنك إنشاء جلسة واحدة فقط لكل نشاط. لإنشاء جلسة، عليك تمرير ملف activity إلى الطريقة create، كما هو موضّح في المثال التالي. قد تؤدي محاولة إنشاء جلسة على جهاز غير متوافق إلى ظهور أخطاء أثناء التشغيل.

import androidx.xr.scenecore.Session

class myActivity : Activity() {
  val xrSession = Session.create(this)
}

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

انظر أيضًا