تشرين الثاني (نوفمبر) 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.