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