تحسين تجارب التطبيقات باستخدام الإدراك من خلال 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 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. */)
}
Session.kt

عند إيقاف نشاط الجلسة، يتم إيقاف جميع محتوى الواقع المعزّز المرتبط بهذه الجلسة، وتصبح الجلسة غير صالحة.

ضبط جلسة

قد تكون بعض الميزات غير مفعّلة تلقائيًا ويجب ضبطها لكي تعمل. لضبط جلسة، استخدِم 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
• تتبُّع وضعية الجهاز باستخدام ARCore for Jetpack XR