Mengaktifkan AR di aplikasi AR Foundation (khusus Android)

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

Mengonfigurasi aplikasi Anda agar menjadi AR Diperlukan atau AR Opsional

Untuk menghemat ruang di perangkat individual, 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 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 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 tidak berlaku lagi 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 AR Optional 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 membutuhkan ARCore untuk fungsionalitas dasar. ARCore meningkatkan fungsionalitas 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 dengan 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 semua fungsi AR memerlukan setidaknya Android 7.0 (API Level 24)
Harus menggunakan ARSession.state untuk memeriksa dukungan ARCore dan status penginstalan
Harus menggunakan coroutine ARSession.Install() 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 Android ikon.

  3. Di bagian Other Settings > Identification, tentukan Minimum API Level yang 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 iOS ikon.

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

Menjadikan aplikasi AR Opsional

Android

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

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

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

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

iOS

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

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

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

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

Menjalankan pemeriksaan runtime

Memeriksa apakah Layanan Google Play untuk AR telah diinstal

Aplikasi AR Diperlukan dan AR Optional harus menggunakannya coroutine ARSession.Install() sebelum membuat sesi ARCore untuk memeriksa apakah versi Layanan Google Play yang kompatibel untuk AR (masih) sudah diinstal 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 tidak diinstal (mungkin karena dihapus oleh pengguna) atau versi terlalu lama, aplikasi akan meminta pengguna untuk menginstal atau memperbaruinya.
  • Memiliki data profil perangkat ARCore terbaru — jika sudah tidak berlaku, aplikasi Anda akan mengunduh data baru.

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

Kondisi Tindakan
Perangkat tidak mendukung ARCore. Menyembunyikan fungsi terkait AR.
Perangkat mendukung ARCore, tetapi Google Play Services for AR dan/atau Data profil perangkat ARCore tidak diinstal atau sudah tidak berlaku. Meminta pengguna menginstal atau mengupdate Google Play Services for AR dan/atau Data profil perangkat ARCore dengan memanggil ARSession.Install().
Perangkat mendukung ARCore, Google Play Services for AR, dan Data profil perangkat ARCore diinstal dan diperbarui. 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 Anda di Play Store, pastikan aplikasi mematuhi persyaratan ARCore Persyaratan Privasi Pengguna.

Langkah selanjutnya