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

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

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

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

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

  1. تم تجميع تطبيقك باستخدام حزمة تطوير برامج (SDK) متأثّرة.
  2. يستخدم تطبيقك أيًا من واجهات برمجة التطبيقات المتأثرة التالية:
إذا تم تجميع تطبيقك باستخدام
إصدار AR Foundation...
وتستخدم واجهات برمجة التطبيقات المتأثرة... خلل في الأداء اعتبارًا من تشرين الثاني (نوفمبر) 2022
AR Foundation 2.1 (Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) تعرِض false.

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

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

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

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