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ı

Kasım 2022'de AR için Google Play Hizmetleri, NDK kamera görüntüleri ve meta verileriyle ilgili kullanımdan kaldırılan yöntemleri kaldıracaktır.

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

Etkilenen uygulamalar

Kasım 2022'den itibaren, kullanıcılar aşağıdaki durumlarda AR için Google Play Hizmetleri'nin en son sürümüne güncelleme yaptıklarında uygulamanız çalışmayı durdurabilir veya kilitlenebilir:

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

Etkilenen uygulamaları düzeltme

Etkilenen uygulamalarda Kasım 2022'den itibaren bozulabilir. Bu sorunu gidermek için Unity sürümünüzün desteklediği AR Foundation'ın en son sürümüne güncelleyin. En azından, AR Foundation 4.x veya sonraki bir sürümüne güncelleyin.

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

Kasım 2022'deki değişiklikleri önceden simüle ederek uygulamanızın AndroidManifest.xml öğesine özel bir meta-data girişi ekleyerek uygulamayı test edin:

  1. Hedef cihazda AR için Play Hizmetleri'nin 1.29.0 veya sonraki bir sürümünü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ınlanan uygulamanızda yerinde bırakırsanız gelecekte beklenmedik davranışlara neden olabilirsiniz.

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

Zaman çizelgesi

Dönem Etkinlikler
Kasım 2020
(ARCore SDK sürümü 1.20.0)		 Yerel API'leri kullanımdan kaldırın.
Alternatif yerel API'ler kullanmak için uygulamayı güncelleyin.
Kasım 2021 Etkilenen API'lerin AR için Google Play Hizmetleri'nden kaldırılması işleminin Kasım 2022'de devam etmesi nedeniyle gelecekte gerçekleşecek zarar verici değişiklikleri 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 zarar verme değişikliği sunun.