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 yang terkait dengan metadata dan gambar kamera NDK.

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

Aplikasi yang terkena dampak

Mulai November 2022, aplikasi Anda mungkin berhenti berfungsi atau error saat pengguna mengupdate ke Layanan Google Play untuk AR versi terbaru 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 dapat menyebabkan gangguan mulai pada 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.

Perbaiki aplikasi yang terpengaruh

Aplikasi yang terkena dampak mungkin mengalami kerusakan pada November 2022. Untuk memitigasi hal ini, membangun ulang aplikasi Anda menggunakan ARCore SDK terbaru. Setidaknya, Anda harus upgrade ke ARCore SDK versi 1.20.0 atau yang lebih baru.

Verifikasi bahwa aplikasi yang terpengaruh telah diperbaiki

Uji aplikasi dengan menyimulasikan perubahan pada November 2022 di awal 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 elemen File AndroidManifest.xml :

    <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 sebagai yang diharapkan.

  4. Hapus tag <meta-data> saat pengujian selesai. Membiarkan tag ini diterapkan dalam aplikasi yang dipublikasikan dapat mengakibatkan perilaku yang tidak terduga di masa depan.

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

Linimasa

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