تحسين تجارب التطبيقات باستخدام الإدراك من خلال ARCore في Jetpack XR

أجهزة XR المشمولة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.
مزيد من المعلومات حول أنواع أجهزة XR →
سماعات الرأس بنظام الواقع الممتد
نظارات سلكية بنظام الواقع الممتد
نظارات بشاشة عرض
وميزات صوتية
مزيد من المعلومات حول أنواع أجهزة XR →

توفّر حزمة ARCore for Jetpack XR إمكانات إدراك قوية لتطبيقك من أجل فهم العالم الحقيقي من خلال مجموعة متنوعة من واجهات برمجة التطبيقات. تساعدك بعض واجهات برمجة التطبيقات هذه في تحسين التجارب الغامرة للأجهزة، مثل سماعات الرأس بنظام الواقع الممتد ونظارات الواقع الممتد السلكية، ويساعدك بعضها في تحسين تجارب الواقع المعزّز للأجهزة، مثل النظارات بالذكاء الاصطناعي، ويساعدك بعضها في تحسين تجارب التطبيقات لجميع أنواع أجهزة Android XR.

على سبيل المثال، يمكنك استخدام ARCore for Jetpack XR لاسترداد البيانات المستوية أو تثبيت المحتوى في موقع ثابت في المساحة أو استخدام وضعية جغرافية مكانية لتثبيت المحتوى في موقع جغرافي حقيقي.

إضافة تبعيات المكتبة

قبل البدء في استخدام ميزات الإدراك في تطبيق XR، أضِف التبعيات اللازمة، استنادًا إلى نوع تجارب التطبيق التي تحسّنها باستخدام الواقع المعزّز.

الوصول إلى جلسة

تعتمد ميزات الإدراك في ARCore for Jetpack XR على Session، الذي يستخدم Jetpack XR Runtime.

تعتمد طريقة وصول تطبيقك إلى الجلسة على أنواع تجارب التطبيق التي يتم تحسينها باستخدام ميزات الإدراك:

إنشاء جلسة باستخدام Jetpack XR Runtime

لإنشاء جلسة، مرِّر Context إلى طريقة create(). يمكن أن يكون هذا Context عبارة عن Activity على أجهزة XR الغامرة أو الأجهزة الجوّالة، أو سياق معروض على النظارات الذكية.

قد يكون إنشاء جلسة ARCore مهمة مكلفة، ويجب معالجتها في الخلفية، كما هو موضّح في المثال التالي:

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

يمكن أن تستخدم الدالة create() مَعلمة LifecycleOwner اختيارية، ما يسمح بإدارة مراحل نشاط الجلسة من خلال LifecycleOwner مختلفة. يجب أن تبدأ LifecycleOwner مراحل نشاطها وتنتهي ضمن نطاق السياق المقدَّم، وإلا قد تكون Session عرضة للتسريبات.

ضبط جلسة

قد تكون بعض الميزات غير مفعَّلة تلقائيًا ويجب ضبطها لكي تعمل. لضبط جلسة، استخدِم configure() وحدِّد خيارات الضبط التي يحتاجها Session. للحصول على تفاصيل حول الإعدادات المطلوبة لميزات الواقع المعزّز المختلفة، يُرجى الاطّلاع على الصفحات المقابلة لكل ميزة من ميزات الواقع المعزّز.

الخطوات التالية

بعد أن يبدأ تطبيقك جلسة، يمكنك استكشاف طرق استخدامها لتحسين تجارب التطبيق على أجهزة XR المختلفة: