Google berkomitmen untuk memajukan kesetaraan rasial bagi komunitas Kulit Hitam. Lihat bagaimana.

Aktifkan ARCore

Halaman ini menjelaskan cara mengaktifkan fungsionalitas ARCore di proyek Unity Anda. Untuk melakukan ini, Anda perlu:

  1. Impor ARCore SDK untuk Unity
  2. Konfigurasi aplikasi Anda menjadi AR Diperlukan atau AR Opsional
  3. Pastikan aplikasi Anda mematuhi Persyaratan Privasi Pengguna ARCore

Layanan Google Play untuk AR

ARCore SDK membuat fitur AR tersedia di perangkat yang didukung ARCore yang telah menginstal Layanan Google Play untuk AR (ARCore).

Layanan Google Play untuk AR dipasang secara otomatis dan selalu diperbarui di sebagian besar perangkat yang didukung.

Sebelum memulai sesi AR, aplikasi harus:

  1. Periksa apakah ARCore didukung, dengan memanggil CheckApkAvailability .
  2. Periksa apakah Layanan Google Play untuk AR sudah diinstal dan terbaru, dan data profil perangkat ARCore yang diperlukan telah didownload, dengan memanggil Session.RequestApkInstallation(bool userRequested) .

Impor ARCore SDK untuk Unity

Unduh ARCore SDK untuk Unity dan impor ke dalam proyek Anda dengan mengklik menu Assets> Import package> Custom Package . (Khusus Unity 2019 : Untuk memperbaiki kesalahan kompilasi, gunakan Window> Package Manager untuk menginstal paket Multiplayer HLAPI dan XR Legacy Input Helpers .)

Di jendela Unity's Project, Anda akan melihat file SDK dan aplikasi sampel HelloAR di Assets/GoogleARCore/Examples/HelloAR/ .

Konfigurasi aplikasi Anda menjadi AR Diperlukan atau AR Opsional

Aplikasi yang mendukung fitur AR dapat dikonfigurasi dengan dua cara: AR Diperlukan dan AR Opsional . Jika Anda memerlukan bantuan untuk memutuskan mana yang akan dipilih, lihat Publikasikan Aplikasi AR di Google Play Store .

AR Diperlukan

Agar dapat digunakan, aplikasi yang Diperlukan AR memerlukan Perangkat yang Didukung ARCore yang memiliki Layanan Google Play untuk AR terpasang di dalamnya.

  • Google Play Store membuat aplikasi yang Diperlukan AR hanya tersedia di perangkat yang mendukung ARCore .

  • Saat pengguna memasang aplikasi yang Dibutuhkan AR, Google Play Store secara otomatis memasang Layanan Google Play untuk AR . Namun, aplikasi Anda masih harus melakukan pemeriksaan waktu proses tambahan jika Layanan Google Play untuk AR harus diupdate atau telah di-uninstal secara manual, atau data profil perangkat ARCore sudah tidak update.

Untuk informasi lebih lanjut, lihat Menerbitkan Aplikasi AR di Google Play Store .

Untuk membuat aplikasi AR Diperlukan, pastikan item menu Edit> Project Settings> ARCore> ARCore Required dicentang seperti yang ditunjukkan di bawah ini. Ini dicentang secara default.

Aplikasi Anda akan secara otomatis melakukan pemeriksaan waktu proses untuk memastikan bahwa perangkat mendukung ARCore dan memiliki Layanan Google Play untuk AR terpasang dan bahwa data profil perangkat ARCore adalah yang terbaru. Jika Layanan Google Play untuk AR tidak diinstal (mungkin karena telah dihapus oleh pengguna) atau versinya terlalu lama, aplikasi Anda akan meminta pengguna untuk menginstal atau mengupdatenya. Jika data profil perangkat ARCore bukan yang terbaru, aplikasi Anda akan mengunduh dan memperbaruinya. Jika penginstalan atau pembaruan gagal (mungkin karena kegagalan jaringan), Session.Status akan mengembalikan kesalahan, dan aplikasi Anda harus menangani kesalahan tersebut dan berhenti.

AR Opsional

Aplikasi AR Opsional memiliki fitur AR opsional, yang hanya diaktifkan di perangkat yang menginstal Layanan Google Play untuk AR .

  • Aplikasi opsional AR dapat diinstal dan dijalankan di perangkat yang tidak mendukung ARCore.

  • Saat pengguna memasang aplikasi AR Opsional, Google Play Store tidak akan secara otomatis memasang Layanan Google Play untuk AR dengan aplikasi tersebut.

Untuk membuat aplikasi AR Opsional, hapus centang pada item menu Edit> Project Settings> ARCore> ARCore Required .

Lakukan pemeriksaan runtime

Saat diluncurkan, aplikasi Anda harus memanggil Session.CheckApkAvailability() untuk memeriksa apakah perangkat mendukung ARCore dan, jika demikian, apakah data profil perangkat Google Play Services untuk AR dan ARCore sudah diinstal dan terbaru.

Aplikasi Anda harus menangani kondisi berikut:

Kondisi Tindakan
Perangkat tidak mendukung ARCore. Menyembunyikan fungsionalitas terkait AR.
Perangkat mendukung ARCore, tetapi Layanan Google Play untuk AR dan / atau data profil perangkat ARCore tidak diinstal atau sudah usang. Meminta pengguna untuk menginstal atau mengupdate Layanan Google Play untuk AR dan / atau data profil perangkat ARCore dengan memanggil Session.RequestApkInstallation() .
Perangkat mendukung ARCore dan Layanan Google Play untuk AR dan ARCore data profil perangkat diinstal dan diperbarui. Membuat Session ARCore dan mulai menggunakan ARCore.

Persyaratan Privasi Pengguna

Pastikan aplikasi Anda mematuhi Persyaratan Privasi Pengguna ARCore.

Langkah selanjutnya

Baca kode di aplikasi sampel dan ARCore untuk referensi Unity API .