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

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

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

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

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

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

إذا تم تجميع تطبيقك باستخدام إصدار AR Foundation…	وتستخدم واجهات برمجة التطبيقات المتأثرة…	إيقاف السلوك نهائيًا اعتبارًا من تشرين الثاني (نوفمبر) 2022
AR Foundation 2.1 (Unity 2019 LTS)	`XRCameraSubsystem.TryGetLatestImage(out XRCameraImage)`	عرض القيمة `false`

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

قد تتوقّف التطبيقات المتأثرة عن العمل في تشرين الثاني (نوفمبر) 2022. للحدّ من هذه المشكلة، عليك التحديث إلى أحدث إصدار من AR Foundation يتيحه إصدار Unity. يجب تحديث الإصدار إلى AR Foundation 4.x أو إصدار أحدث على الأقل.

التأكّد من حلّ المشكلة في التطبيق المتأثّر

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

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

أضِف علامة <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>

اختبِر تطبيقك وتأكَّد من أنّ جميع ميزات ARCore تعمل على النحو المُتوقّع.
أزِل علامة <meta-data> عند اكتمال الاختبار. قد يؤدي ترك هذه العلامة في تطبيقك المنشور إلى حدوث سلوك غير متوقّع في المستقبل.

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

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

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