Mengaktifkan AR di aplikasi AR Foundation (khusus Android)

Aktifkan AR untuk menggunakan fitur augmented reality di aplikasi baru atau yang sudah ada.

Mengonfigurasi aplikasi menjadi Wajib AR atau AR Opsional

Untuk menghemat ruang di setiap perangkat, semua fitur AR disimpan di aplikasi bernama Layanan Google Play untuk AR yang diupdate secara terpisah oleh Play Store. Aplikasi Android yang menggunakan fitur AR berkomunikasi dengan Layanan Google Play untuk AR menggunakan ARCore SDK. Aplikasi yang mendukung fitur AR dapat dikonfigurasi dengan dua cara: AR Diperlukan dan AR Opsional. Penetapan ini menentukan cara aplikasi berinteraksi dengan Layanan Google Play untuk aplikasi AR.

Aplikasi AR Diperlukan tidak dapat berfungsi tanpa ARCore. Fitur ini memerlukan perangkat yang didukung ARCore yang telah menginstal Layanan Google Play untuk AR.

  • Google Play Store hanya akan menyediakan aplikasi yang Diperlukan AR di perangkat yang mendukung ARCore.
  • Saat pengguna menginstal aplikasi yang Diperlukan AR, Google Play Store akan otomatis menginstal Layanan Google Play untuk AR di perangkat mereka. Namun, aplikasi Anda tetap harus melakukan pemeriksaan runtime tambahan jika Layanan Google Play untuk AR sudah tidak berlaku atau telah di-uninstal secara manual.

Aplikasi AR Optional menggunakan ARCore untuk meningkatkan fungsi yang ada. Layanan ini memiliki fitur AR opsional yang hanya diaktifkan pada perangkat yang didukung ARCore yang telah menginstal Layanan Google Play untuk AR.

  • Aplikasi Opsional AR dapat diinstal dan dijalankan di perangkat yang tidak mendukung ARCore.
  • Saat pengguna menginstal aplikasi AR Optional, Google Play Store tidak akan otomatis menginstal Layanan Google Play untuk AR di perangkat.
Diperlukan ARAR Opsional
Penggunaan Fitur AR Aplikasi Anda memerlukan ARCore untuk fungsi dasar. ARCore meningkatkan fungsi aplikasi Anda. Aplikasi Anda dapat berjalan tanpa dukungan ARCore.
Visibilitas Play Store Aplikasi Anda hanya tercantum di Play Store pada perangkat yang mendukung ARCore. Aplikasi Anda mengikuti prosedur listingan normal.
Metode penginstalan Layanan Google Play untuk AR Play Store menginstal Layanan Google Play untuk AR bersama aplikasi Anda. Aplikasi Anda menggunakan coroutine ARSession.Install() untuk mendownload dan menginstal ARCore.
Persyaratan minSdkVersion Android Android 7.0 (Level API 24) Android 4.4 (API Level 19), meskipun menjalankan fungsi AR apa pun memerlukan setidaknya Android 7.0 (API Level 24)
Harus menggunakan ARSession.state untuk memeriksa dukungan ARCore dan status penginstalan
Harus menggunakan coroutine ARSession.Install() untuk menginstal Layanan Google Play untuk AR

Menjadikan aplikasi Anda Diperlukan AR

Android

  1. Buka Edit > Project Settings > XR Plug-in Management > ARCore Requirement disetel ke Required secara default.

  2. Klik Edit > Project Settings > Player, pilih tab dengan ikon Android.

  3. Di bagian Other Settings > Identification, tentukan Minimum API Level yang berupa 24 atau lebih tinggi.

iOS

  1. Buka Edit > Project Settings > XR Plug-in Management > ARKit Requirement disetel ke Required secara default.

  2. Klik Edit > Project Settings > Player, pilih tab dengan ikon iOS.

  3. Di bagian Other Settings > Configuration, tentukan Target minimum iOS Version untuk aplikasi Anda.

Menjadikan AR aplikasi Anda Opsional

Android

  1. Buka Edit > Project Settings > XR Plug-in Management > ARCore

  2. Dari menu drop-down Requirement, pilih Optional untuk menetapkan aplikasi Anda ke AR opsional.

  3. Klik Edit > Project Settings > Player, pilih tab dengan ikon Android.

  4. Di bagian Other Settings > Identification, tentukan Minimum API Level yang berupa 24 atau lebih tinggi.

iOS

  1. Buka Edit > Project Settings > XR Plug-in Management > ARKit

  2. Dari menu drop-down Requirement, pilih Optional untuk menetapkan aplikasi Anda ke AR Optional.

  3. Klik Edit > Project Settings > Player, pilih tab dengan ikon iOS.

  4. Di bagian Other Settings > Configuration, tentukan Target minimum iOS Version untuk aplikasi Anda.

Melakukan pemeriksaan runtime

Memeriksa apakah Layanan Google Play untuk AR telah diinstal

Aplikasi Diperlukan AR dan Opsional AR harus menggunakan coroutine ARSession.Install() sebelum membuat sesi ARCore untuk memeriksa apakah versi Layanan Google Play yang kompatibel untuk AR telah diinstal (masih) dan untuk memastikan bahwa semua data profil perangkat ARCore yang diperlukan telah didownload.

Selama runtime, aplikasi yang Diperlukan AR akan otomatis melakukan pemeriksaan runtime untuk memastikan bahwa perangkat target:

  • Mendukung ARCore
  • Telah menginstal Google Play Services for AR — jika ini tidak diinstal (mungkin karena telah dihapus oleh pengguna) atau versi terlalu lama, aplikasi Anda akan meminta pengguna untuk menginstal atau mengupdatenya.
  • Memiliki data profil perangkat ARCore terbaru — jika data tersebut sudah tidak berlaku, aplikasi Anda akan mendownload data baru.

Tetapkan ARSession.attemptUpdate ke false untuk menonaktifkan pemeriksaan default ini. Aplikasi Anda tetap harus menangani kondisi ini:

Kondisi Tindakan
Perangkat tidak mendukung ARCore. Menyembunyikan fungsi terkait AR.
Perangkat mendukung ARCore, tetapi data profil perangkat Google Play Services for AR dan/atau ARCore belum diinstal atau sudah tidak berlaku. Meminta pengguna menginstal atau mengupdate data profil perangkat Google Play Services for AR dan/atau ARCore dengan memanggil ARSession.Install().
Perangkat mendukung ARCore dan Google Play Services for AR, serta data profil perangkat ARCore telah diinstal dan yang terbaru. Membuat Session ARCore dan mulai menggunakan ARCore.

Anda juga dapat memeriksa ARSession.state untuk mengetahui status penginstalan dan dukungan.

Mematuhi Persyaratan Privasi Pengguna

Untuk memublikasikan aplikasi di Play Store, pastikan aplikasi Anda mematuhi Persyaratan Privasi Pengguna ARCore.

Langkah selanjutnya