November 2022 tidak menggunakan lagi penghapusan metode kamera untuk ARCore SDK for Android (Kotlin/Java)

Pada November 2022, Layanan Google Play untuk AR akan menghapus metode yang tidak digunakan lagi terkait gambar dan metadata kamera NDK.

Aplikasi yang menggunakan metode ini dalam versi ARCore SDK yang terpengaruh mungkin mulai berperilaku berbeda atau error saat pengguna mengupdate Layanan Google Play untuk AR.

Aplikasi yang terkena dampak

Mulai November 2022, aplikasi Anda dapat berhenti berfungsi atau mengalami error saat pengguna mengupdate ke versi terbaru Layanan Google Play untuk AR jika:

1. Aplikasi Anda dikompilasi dengan SDK yang terpengaruh
2. Aplikasi Anda menggunakan salah satu API yang terpengaruh berikut:

Jika aplikasi Anda dikompilasi dengan versi ARCore SDK…	Dan menggunakan API yang terpengaruh...	Perilaku yang tidak berfungsi mulai November 2022
1.19.0 atau yang lebih rendah	Frame.getImageMetadata()	Menampilkan IllegalArgumentException.
1.10.0 atau yang lebih rendah	Frame.acquireCameraImage()	Menampilkan gambar berukuran 0x0.

Memperbaiki aplikasi yang terpengaruh

Aplikasi yang terpengaruh mungkin mengalami kerusakan pada November 2022. Untuk mengurangi hal ini, buat ulang aplikasi Anda menggunakan ARCore SDK terbaru. Minimal, Anda harus mengupgrade ke ARCore SDK versi 1.20.0 atau yang lebih baru.

Memverifikasi bahwa aplikasi yang terpengaruh telah diperbaiki

Uji aplikasi dengan menyimulasikan perubahan November 2022 terlebih dahulu dengan menambahkan entri meta-data khusus ke AndroidManifest.xml aplikasi Anda:

1. Pastikan Layanan Play untuk AR versi 1.29.0 atau yang lebih tinggi diinstal di perangkat target.

2. Tambahkan tag <meta-data> baru sebagai turunan dari elemen <application> yang ada di file AndroidManifest.xml aplikasi :

   <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. Uji aplikasi Anda dan pastikan semua fitur ARCore berfungsi seperti yang diharapkan.

4. Hapus tag <meta-data> setelah pengujian selesai. Membiarkan tag ini tetap ada di aplikasi yang dipublikasikan dapat menyebabkan perilaku yang tidak terduga di masa mendatang.

Jika aplikasi berfungsi normal, aplikasi siap untuk perubahan pada November 2022.

Linimasa

Periode	Acara
November 2020 (ARCore SDK versi 1.20.0)	Menghentikan penggunaan API native. Perbarui implementasi untuk menggunakan API native alternatif.
November 2021	Mengumumkan perubahan yang akan menyebabkan gangguan karena penghapusan penerapan API yang terpengaruh dari Layanan Google Play untuk AR yang tertunda pada November 2022.
November 2022	Hapus implementasi API yang terpengaruh dari Layanan Google Play untuk AR. Memperkenalkan perubahan yang menyebabkan error untuk aplikasi yang menggunakan versi ARCore sebelum 1.20.0.