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

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

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

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

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

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

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

إذا تم تجميع تطبيقك باستخدام إصدار ARCore SDK...	وتستخدم واجهات برمجة التطبيقات المتأثرة...	خلل في الأداء اعتبارًا من تشرين الثاني (نوفمبر) 2022
1.22.0 أو أقل	ArImage_getNdkImage() (تمت الإزالة في ARCore SDK 1.23.0)	تعرض NULL في بنية AImage الناتجة.
1.22.0 أو أقل	ArImage_getNdkCameraMetadata() (تمت الإزالة في ARCore SDK 1.23.0)	تعرض 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 SDK)	يمكنك إيقاف واجهات برمجة التطبيقات المتأثرة وتقديم بدائل واجهات برمجة التطبيقات المنسدلة.
شباط (فبراير) 2021 (الإصدار 1.23.0 من حزمة ARCore SDK)	عليك إزالة توقيعات واجهات برمجة التطبيقات المتوقّفة سابقًا من ARCore SDK.
تشرين الثاني (نوفمبر) 2021	الإعلان عن تغيير قد يؤدي إلى عطل في المستقبل بسبب الإزالة المعلّقة لتطبيق واجهات برمجة التطبيقات المتأثرة من خدمات Google Play للواقع المعزّز في تشرين الثاني (نوفمبر) 2022
تشرين الثاني (نوفمبر) 2022	يُرجى إزالة تنفيذ واجهات برمجة التطبيقات المتأثرة من "خدمات Google Play للواقع المعزّز". أدخِل تغييرات قد تؤدي إلى أعطال في التطبيقات التي تستخدم إصدارات ARCore التي تسبق الإصدار 1.23.0.