توفّر حزمة ARCore for Jetpack XR إمكانات إدراكية قوية لتطبيقك كي يتمكّن من فهم العالم الحقيقي من خلال مجموعة متنوعة من واجهات برمجة التطبيقات. تساعدك بعض واجهات برمجة التطبيقات هذه في تحسين التجارب الغامرة على أجهزة مثل سمّاعات الرأس ونظارات الواقع المختلط السلكية، وتساعدك بعضها الآخر في تحسين تجارب الواقع المعزّز على أجهزة مثل نظارات الذكاء الاصطناعي، وتساعدك بعضها في تحسين تجارب التطبيقات على جميع أنواع أجهزة Android XR.
على سبيل المثال، يمكنك استخدام ARCore في Jetpack XR لاسترداد البيانات المستوية أو ربط المحتوى بموقع جغرافي ثابت في الفضاء أو استخدام وضع جغرافي مكاني لربط المحتوى بموقع جغرافي في العالم الحقيقي.
إضافة تبعيات المكتبة
قبل البدء في استخدام ميزات الإدراك في تطبيق الواقع الممتد، عليك إضافة التبعيات اللازمة، وذلك حسب نوع تجارب التطبيق التي تريد تحسينها باستخدام الواقع المعزّز.
الوصول إلى جلسة
تعتمد ميزات الإدراك في ARCore for Jetpack XR على Session،
الذي يستخدم Jetpack XR Runtime.
تعتمد طريقة وصول تطبيقك إلى جلسة على أنواع تجارب التطبيق التي تريد تحسينها باستخدام ميزات الإدراك:
- إذا كان تطبيقك يحسّن التجارب الغامرة باستخدام واجهة مستخدم مكانية من خلال Jetpack Compose for XR، يمكنك الوصول إلى جلسة من Jetpack Compose for XR.
- في جميع الحالات الأخرى، يمكنك الوصول إلى جلسة من Jetpack XR Runtime، وهو ما يتم تناوله في القسم التالي من هذه الصفحة.
الوصول إلى جلسة من Jetpack XR Runtime
للوصول إلى جلسة من Jetpack XR Runtime، عليك إنشاؤها باتّباع الخطوات التالية:
لإنشاء جلسة، مرِّر [Context] إلى طريقة create(). يمكن أن يكون هذا Context Activity على أجهزة XR الغامرة أو الأجهزة الجوّالة، أو سياقًا معروضًا.
يمكن أن يكون إنشاء جلسة ARCore مهمة مكلفة، ويجب معالجتها في الخلفية، كما هو موضّح في المثال التالي:
when (val result = Session.create(context)) { is SessionCreateSuccess -> { val xrSession = result.session // ... } else -> TODO(/* A different unhandled exception was thrown. */) }
عند إيقاف نشاط جلسة، يتم إيقاف كل محتوى الواقع المعزّز المرتبط بهذه الجلسة، وتصبح الجلسة غير صالحة.
ضبط إعدادات جلسة
قد تكون بعض الميزات غير مفعَّلة تلقائيًا ويجب ضبطها لكي تعمل. لضبط إحدى الجلسات، استخدِم configure() وحدِّد خيارات الضبط التي يحتاجها Session. للحصول على تفاصيل حول الإعدادات المطلوبة لميزات الواقع المعزّز المختلفة، راجِع الصفحات ذات الصلة بكل ميزة من ميزات الواقع المعزّز.
الخطوات التالية
بعد أن يتضمّن تطبيقك جلسة، استكشِف الطرق التي يمكنك استخدامها لتحسين تجارب التطبيق على أجهزة XR المختلفة:
- رصد الطائرات باستخدام ARCore for Jetpack XR
- إنشاء نقاط ارتكاز باستخدام ARCore for Jetpack XR
- التعامل مع الأيدي باستخدام ARCore for Jetpack XR
- دمج ميزة تتبُّع تعابير الوجه في تطبيقك باستخدام ARCore for Jetpack XR
- استرداد معلومات العمق في تطبيقك باستخدام ARCore for Jetpack XR
- تتبُّع وضعية الجهاز باستخدام ARCore for Jetpack XR