Kasım 2022'de Android NDK (C) için ARCore SDK'sına yönelik olarak 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ılan yöntemleri kaldıracak.

ARCore SDK'sını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:

Uygulamanız, etkilenen bir SDK ile derlendi
Uygulamanız, aşağıdaki etkilenen API'lerden herhangi birini kullanıyor:

Uygulamanız şu SDK sürümüyle derlendiyse ARCore SDK sürümü…	Ayrıca etkilenen API'leri kullanıyorsa…	Kasım 2022'den itibaren davranışı bozma
1.22.0 veya daha eski sürümler	`ArImage_getNdkImage()` (ARCore SDK 1.23.0'da kaldırıldı)	Elde edilen `AImage` yapısında `NULL` döndürür.
1.22.0 veya daha eski sürümler	`ArImage_getNdkCameraMetadata()` (ARCore SDK 1.23.0'da kaldırıldı)	Elde edilen `ACameraMetadata` yapısında `NULL` döndürür.

Etkilenen uygulamaları düzeltme

Etkilenen uygulamalarda Kasım 2022'de kesinti yaşanabilir. Bu sorunu azaltmak için etkilenen yöntemler için hazır değişimleri kullanın:

ArImage_getNdkImage() ve AImage_* yöntemleri: ArImage'teki ilgili yöntemleri kullanın. Örneğin:
- AImage_getNumberOfPlanes(), ArImage_getNumberOfPlanes() olur
- AImage_getPlaneData(), ArImage_getPlaneData() olur
ArImage_getNdkCameraMetadata(): Bunun yerine ArImageMetadata_getConstEntry() kullanın

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:

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

Uygulamanın 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>

Uygulamanızı test edin ve tüm ARCore özelliklerinin beklendiği gibi çalıştığını doğrulayın.
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)	Etkilenen API'leri kullanımdan kaldırın, hazır API alternatifleri tanıtın.
Şubat 2021 (ARCore SDK sürümü 1.23.0)	Daha önce desteği sonlandırılan API imzalarını ARCore SDK'sından kaldırın.
Kasım 2021	Etkilenen API'lerin Kasım 2022'de AR için Google Play Hizmetleri'nden kaldırılması nedeniyle gelecekte yapılacak önemli değişikliği duyurma.
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.