Kasım 2022'de, Android NDK için ARCore SDK'sı (AR Foundation) için kullanımdan kaldırılan kamera yöntemlerinin kaldırılması

AR için Google Play Hizmetleri, Kasım 2022'de NDK kamera resimleri ve meta verileriyle ilgili desteği sonlandırılmış yöntemleri kaldıracak.

AR Foundation'ın etkilenen sürümlerinde bu yöntemleri kullanan uygulamalar, kullanıcılar AR için Google Play Hizmetleri'ni güncellediğinde farklı davranmaya başlayabilir veya çökebilir.

Etkilenen uygulamalar

Kasım 2022'den itibaren, kullanıcılar AR için Google Play Hizmetleri'nin en son sürümüne güncelleme yaptığında uygulamanız çalışmayı durdurabilir veya çökebilir. Bunun nedeni aşağıdakilerden biri olabilir:

  1. Uygulamanız, etkilenen bir SDK ile derlendi
  2. Uygulamanız aşağıdaki etkilenen API'lerden birini kullanıyor:
Uygulamanız şu AR Foundation sürümüyle derlendiyse
 Ayrıca etkilenen API'leri kullanıyorsa… Kasım 2022'den itibaren davranışı bozma
AR Foundation 2.1 (Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) false değerini döndürür.

Etkilenen uygulamaları düzeltme

Bu durumdan etkilenen uygulamalarda Kasım 2022'de kesinti yaşanabilir. Bu sorunu azaltmak için Unity sürümünüzün desteklediği en son AR Foundation sürümüne güncelleme yapın. En azından AR Foundation 4.x veya sonraki bir sürüme güncelleyin.

Etkilenen uygulamanın düzeltildiğini doğrulama

Uygulamanızın AndroidManifest.xml bölümüne özel bir meta-data girişi ekleyerek Kasım 2022 değişikliklerini önceden simüle ederek uygulamayı test edin:

  1. Hedef cihazda AR için Play Hizmetleri 1.29.0 veya sonraki bir sürümün yüklü olduğundan emin olun.

  2. Uygulamanın özel AndroidManifest.xml dosyasında mevcut <application> öğesinin alt öğesi olarak yeni bir <meta-data> etiketi ekleyin: 

    <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. Uygulamanızı test edin ve tüm ARCore özelliklerinin beklendiği gibi çalıştığını doğrulayın.

  4. Test tamamlandığında <meta-data> etiketini kaldırın. Bu etiketi yayınlanmış uygulamanızda bırakmanız gelecekte beklenmedik davranışlara neden olabilir.

Uygulama normal çalışıyorsa Kasım 2022'deki değişikliklere hazırdır.

Zaman çizelgesi

Dönem Etkinlikler
Kasım 2020
(ARCore SDK sürümü 1.20.0)		 Yerel API'lerin desteğini sonlandırıyoruz.
Uygulamayı, alternatif yerel API'leri kullanacak şekilde güncelleyin.
Kasım 2021 Etkilenen API'lerin AR için Google Play Hizmetleri'nden uygulanmasının Kasım 2022'de beklemede olması nedeniyle gelecekte zarar verecek bir değişikliği duyurun.
Kasım 2022 Etkilenen API'lerin uygulamasını AR için Google Play Hizmetleri'nden kaldırın.
1.23.0'dan önceki ARCore sürümlerini kullanan uygulamalar için önemli bir değişiklik kullanıma sunuldu.