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 Opsional AR

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 Required dan AR Optional. Penetapan ini menentukan cara aplikasi berinteraksi dengan aplikasi Layanan Google Play untuk AR.

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

  • Google Play Store hanya akan menyediakan aplikasi yang Memerlukan AR di perangkat yang mendukung ARCore.
  • Saat pengguna menginstal aplikasi AR yang diperlukan, Google Play Store akan otomatis menginstal Layanan Google Play untuk AR di perangkatnya. 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. Alat 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 pada 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 AROpsional AR
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 ARSession.state 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 setidaknya Android 7.0 (API Level 24)
Harus menggunakan ARSession.state untuk memeriksa dukungan ARCore dan status penginstalan

Membuat Aplikasi Memerlukan 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.

Menjadikan AR aplikasi 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 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 memanggil ARSession.state sebelum membuat sesi ARCore untuk memeriksa apakah versi Layanan Google Play yang kompatibel untuk AR telah diinstal (masih) dan memastikan bahwa semua data profil perangkat ARCore yang diperlukan telah didownload.

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

  • Mendukung ARCore
  • Telah menginstal Google Play Services for AR — jika aplikasi ini tidak diinstal (mungkin karena aplikasi dihapus oleh pengguna) atau versi yang 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.

Setel ARSession.attemptUpdate ke false untuk menonaktifkan pemeriksaan default ini. Aplikasi Anda tetap harus 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 belum diinstal atau tidak berlaku lagi. Meminta pengguna 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 terbaru. Membuat Session ARCore dan mulai menggunakan ARCore.

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

Mematuhi Persyaratan Privasi Pengguna

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

Langkah selanjutnya