Mengaktifkan AR di aplikasi AR Foundation (khusus Android)

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

Mengonfigurasi aplikasi agar menjadi AR Diperlukan atau AR Opsional

Untuk menghemat ruang di setiap perangkat, semua fitur AR disimpan dalam aplikasi yang disebut 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 Wajib dan AR Opsional. Penetapan ini menentukan cara aplikasi berinteraksi dengan Layanan Google Play untuk aplikasi AR.

Aplikasi yang Diperlukan AR tidak dapat berfungsi tanpa ARCore. Aplikasi 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 Memerlukan 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 fungsionalitas yang ada. Aplikasi ini memiliki fitur AR opsional yang hanya diaktifkan di 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 di 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 (API Level 24) Android 4.4 (API Level 19), meskipun menjalankan fungsi AR apa pun memerlukan minimal Android 7.0 (API Level 24)
Harus menggunakan ARSession.state untuk memeriksa dukungan dan status penginstalan ARCore
Harus menggunakan coroutine ARSession.Install() untuk menginstal Layanan Google Play untuk AR

Membuat aplikasi Anda Wajib 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 bernilai 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.

Membuat 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 bernilai 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 ke AR Opsional.

  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 diinstal

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

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

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

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

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 tidak diinstal atau sudah tidak berlaku. Meminta pengguna untuk menginstal atau mengupdate Google Play Services for AR dan/atau data profil perangkat ARCore dengan memanggil ARSession.Install().
Perangkat mendukung ARCore dan Google Play Services for AR serta data profil perangkat ARCore diinstal dan sudah 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