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ı

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

Şu ürünün etkilenen sürümlerinde bu yöntemleri kullanan uygulamalar: ARCore SDK'sı yeni bir kullanıcılar AR için Google Play Hizmetleri'ni güncellediğinde farklı davranır veya kilitlenir.

Etkilenen uygulamalar

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

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

Uygulamanız ile derlenmişse ARCore SDK sürümü...	Ve etkilenen API'leri kullanır.	Kasım 2022'den itibaren yıkıcı davranış
1.22.0 veya altı	`ArImage_getNdkImage()` (ARCore SDK'sı 1.23.0'dan kaldırıldı)	Sonuçta elde edilen `AImage` yapısında `NULL` değerini döndürür.
1.22.0 veya altı	`ArImage_getNdkCameraMetadata()` (ARCore SDK'sı 1.23.0'dan kaldırıldı)	Sonuçta elde edilen `ACameraMetadata` yapısında `NULL` değerini döndürür.

Etkilenen uygulamaları düzeltme

Bu durumdan etkilenen uygulamalarda Kasım 2022'de kesinti yaşanabilir. Riski azaltmak için yöntemleri uygulayın:

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

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:

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.

Uygulamanın<meta-data><application> AndroidManifest.xml dosya :

<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 gerektiği gibi çalıştığından emin olun. bekleniyor.
Test tamamlandığında <meta-data> etiketini kaldırın. Bu etiketten çıkılıyor uygulamanın işleyiş şeklinin açık olması, duymuş olabilirsiniz.

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

Zaman çizelgesi

Dönem	Etkinlikler
Kasım 2020 (ARCore SDK'sı sürüm 1.20.0)	Etkilenen API'leri kullanımdan kaldırın, kullanıma hazır API alternatiflerini sunun.
Şubat 2021 (ARCore SDK'sı sürüm 1.23.0)	Daha önce kullanımdan kaldırılan API imzalarını ARCore SDK'sından kaldırın.
Kasım 2021	Uygulamanın kaldırılması beklendiği için ileride zarar verecek bir değişikliği duyurma kullanıma sunduk.
Kasım 2022	Etkilenen API'lerin uygulamasını şuradan kaldırın: AR için Google Play Hizmetleri. . Önceki ARCore sürümlerini kullanan uygulamalar için zarar veren değişikliği tanıtma 1.23.0.