تشرين الثاني (نوفمبر) 2022 تم إيقاف العمل بأساليب إزالة الكاميرا من أجل حزمة ARCore SDK لنظام التشغيل Android NDK (C).

في تشرين الثاني (نوفمبر) 2022، ستزيل خدمات Google Play للواقع المعزّز الطُرق المتوقّفة نهائيًا المتعلقة بالصور والبيانات الوصفية لكاميرا NDK.

التطبيقات التي تستخدم هذه الطرق في الإصدارات المتأثرة من حزمة ARCore SDK قد تبدأ في بشكل مختلف أو يتعطّل عندما يحدِّث المستخدمون "خدمات Google Play للواقع المعزّز"

التطبيقات المتأثّرة

ملاحظات مهمّة: ولن تتأثر التطبيقات التي تم تجميعها باستخدام الإصدار 1.23.0 أو إصدار أحدث من حزمة تطوير البرامج ARCore.

اعتبارًا من تشرين الثاني (نوفمبر) 2022، قد يتوقّف تطبيقك عن العمل أو يتعطّل عند تحديث المستخدمين. إلى أحدث إصدار من خدمات Google Play للواقع المعزّز في الحالات التالية:

1. تم تجميع تطبيقك باستخدام حزمة تطوير برامج (SDK) متأثرة.
2. يستخدم تطبيقك أيًا من واجهات برمجة التطبيقات المتأثرة التالية:

إذا كان تطبيقك قد تم تجميعه باستخدام إصدار ARCore SDK...	ويستخدم واجهات برمجة التطبيقات المتأثرة...	الأعطال بدءًا من تشرين الثاني (نوفمبر) 2022
1.22.0 أو أقل	ArImage_getNdkImage() (تمت إزالته في الإصدار 1.23.0 من حزمة تطوير البرامج ARCore)	تعرض NULL في بنية AImage الناتجة.
1.22.0 أو أقل	ArImage_getNdkCameraMetadata() (تمت إزالته في الإصدار 1.23.0 من حزمة تطوير البرامج ARCore)	تعرض NULL في بنية ACameraMetadata الناتجة.

إصلاح التطبيقات المتأثّرة

قد تحدث أعطال في التطبيقات المتأثّرة في تشرين الثاني (نوفمبر) 2022. للتخفيف من ذلك، استخدام البدائل البديلة للطرق المتأثرة:

• ArImage_getNdkImage() وAImage_*: استخدِم الطرق المناسبة من ArImage. مثل:
  • AImage_getNumberOfPlanes() يصبح ArImage_getNumberOfPlanes()
  • AImage_getPlaneData() يصبح ArImage_getPlaneData()
• ArImage_getNdkCameraMetadata(): استخدِم ArImageMetadata_getConstEntry() بدلاً من ذلك.

التأكّد من إصلاح التطبيق المتأثر

يمكنك اختبار التطبيق من خلال محاكاة التغييرات التي أُجريت في تشرين الثاني (نوفمبر) 2022 مسبقًا من خلال إضافة إدخال meta-data خاص إلى AndroidManifest.xml في تطبيقك:

1. تأكّد من تثبيت الإصدار 1.29.0 أو إصدار أحدث من خدمات Play للواقع المعزّز على الجهاز المستهدَف.

2. إضافة علامة <meta-data> جديدة كعنصر ثانوي للعنصر <application> الحالي في التطبيق ملف AndroidManifest.xml :

   <application …>
     …
   
     <!--
          Simulate the November 2022 changes in advance.
          IMPORTANT: Remove this tag when testing is completed.
          Do not include this tag in published versions of your app.
     -->
     <meta-data android:name="com.google.ar.core.session_settings"
                android:value="camera_stack_option,unified_mono" />
   </application>
   

3. اختبِر تطبيقك وتأكَّد من أنّ جميع ميزات ARCore تعمل متوقع.

4. أزِل العلامة <meta-data> عند اكتمال الاختبار. جارٍ ترك هذه العلامة في تطبيقك المنشور إلى سلوك غير متوقع المستقبلية.

إذا كان التطبيق يعمل بشكل طبيعي، سيكون التطبيق جاهزًا للتغييرات في تشرين الثاني (نوفمبر) 2022.

المخطط الزمني

نقطة	فعاليات
تشرين الثاني (نوفمبر) 2020 (الإصدار 1.20.0 من حزمة تطوير البرامج ARCore)	إيقاف واجهات برمجة التطبيقات المتأثرة نهائيًا، وتقديم بدائل لواجهات برمجة التطبيقات غير القابلة للتعديل
شباط (فبراير) 2021 (الإصدار 1.23.0 من حزمة تطوير البرامج ARCore)	يجب إزالة توقيعات واجهات برمجة التطبيقات التي تم إيقافها نهائيًا في السابق من ARCore SDK.
تشرين الثاني (نوفمبر) 2021	الإعلان عن تغيير قد يؤدي إلى عطل في المستقبل بسبب تعليق عملية التنفيذ من واجهات برمجة التطبيقات المتأثرة من "خدمات Google Play للواقع المعزّز" في تشرين الثاني (نوفمبر) 2022
تشرين الثاني (نوفمبر) 2022	إزالة تنفيذ واجهات برمجة التطبيقات المتأثرة من "خدمات Google Play للواقع المعزّز" إدخال تغيير قد يؤدي إلى أعطال في التطبيقات التي تستخدم إصدارات ARCore قبل 1.23.0.