Memulai dengan AR Foundation

AR Foundation Unity adalah framework lintas platform yang memungkinkan Anda menulis pengalaman augmented reality satu kali, lalu mem-build untuk perangkat Android atau iOS tanpa melakukan perubahan tambahan. Framework ini tersedia melalui paket AR Foundation Unity.

Paket ARCore Extensions untuk AR Foundation opsional dari ARCore menambahkan fungsi tambahan yang memungkinkan Anda menggunakan fitur seperti Cloud Anchors, filter konfigurasi Kamera, serta Perekaman dan Pemutaran ke aplikasi Anda.

Memigrasikan atau mengupgrade project yang ada

  • Untuk memigrasikan project yang ada dari ARCore SDK (yang tidak digunakan lagi) untuk Unity ke AR Foundation dan opsional ekstensi ARCore, lihat panduan migrasi.
  • Untuk mengupgrade project yang sudah ada dari versi AR Foundation versi sebelumnya, lihat panduan upgrade dan migrasi Unity.

Persyaratan

Bergantung pada platform target, paket AR Foundation memerlukan hal berikut:

Android

Hardware [Hardware]

  • Perangkat atau emulator Android yang didukung ARCore
  • Kabel USB untuk menghubungkan perangkat ke mesin pengembangan

Perangkat Lunak

iOS

Hardware [Hardware]

Perangkat Lunak

Menginstal AR Foundation

Ikuti langkah-langkah berikut untuk menginstal paket Unity AR Foundation.

  1. Buka project Unity yang ada, atau buat project 3D baru.

  2. Buka Window > Package Manager

  3. Di samping Packages, pilih Unity Registry.

  4. Di kotak penelusuran, ketik "AR Foundation".

  5. Klik Install.

Menginstal dan mengaktifkan paket plugin khusus platform

Paket AR Foundation menyajikan antarmuka yang dapat digunakan developer Unity, tetapi tidak menerapkan fitur AR apa pun. Untuk menggunakan AR Foundation di perangkat target, Anda juga perlu menginstal paket terpisah dan mengaktifkan plugin yang sesuai untuk masing-masing platform.

Android

Paket ARCore XR Plugin memungkinkan Anda membuat aplikasi augmented reality untuk perangkat Android. Ikuti langkah-langkah berikut untuk menginstalnya di project Unity Anda jika aplikasi menargetkan perangkat Android. Gunakan versi yang sama dengan paket AR Foundation untuk menghindari masalah kompatibilitas.

  1. Pada project Anda, buka Window > Package Manager.

  2. Di samping Packages, pilih Unity Registry.

  3. Pada kotak penelusuran, ketik "plugin ARCore XR".

  4. Klik Install.

  5. Buka Edit > Project Settings Di XR Plug-in Management, buka tab Android dan aktifkan ARCore.

iOS

Plugin ARKit XR memungkinkan Anda membuat aplikasi augmented reality untuk perangkat iOS. Ikuti langkah-langkah berikut untuk menginstalnya di project Unity Anda jika aplikasi menargetkan perangkat iOS. Gunakan versi yang sama dengan paket AR Foundation untuk menghindari masalah kompatibilitas.

  1. Pada project Anda, buka Window > Package Manager.

  2. Di samping Packages, pilih Unity Registry.

  3. Di kotak penelusuran, ketik "plugin ARKit XR".

  4. Klik Install.

  5. Buka Edit > Project Settings Di XR Plug-in Management, buka tab iOS dan aktifkan ARKit.

Mengonfigurasi Sesi AR dan menambahkan komponen AR Foundation ke scene Anda

scene memerlukan sesi AR untuk mengaktifkan proses AR, seperti pelacakan gerakan, pemahaman lingkungan, dan estimasi pencahayaan. Anda memerlukan objek game berikut untuk mendukung sesi AR:

  • AR Session: Mengontrol siklus proses pengalaman AR.

  • AR Session Origin: Mengubah koordinat AR menjadi koordinat dunia Unity.

Sebelum menambahkan objek game baru, hapus Main Camera default. Menggantinya dengan AR Camera baru di AR Session Origin.

Tambahkan objek game AR baru ke scene Anda: klik kanan panel Hierarchy lalu pilih XR. Tambahkan AR Session baru dan objek game AR Session Origin baru.

Mengonfigurasi Setelan Pemutar

Android

  1. Buka File > Build Settings untuk membuka jendela Build Settings.
  2. Di bagian Platform, pilih Android lalu klik Switch Platform.
  3. Klik Player Settings.
  4. Terapkan perubahan berikut:

    Player Settings > … Nilai
    Other Settings > Rendering Hapus centang Auto Graphics API.
    Jika Vulkan tercantum di bagian Graphics APIs, hapus karena Vulkan belum didukung oleh ARCore.
    Other Settings > Package Name Buat ID aplikasi unik menggunakan format nama paket Java.
    Misalnya, gunakan com.example.helloAR.
    Other Settings > Minimum API Level Jika Anda mem-build aplikasi AR Diperlukan, tentukan Android 7.0 'Nougat' (API Level 24) or higher.
    Jika Anda membuat aplikasi AR Opsional, tentukan Android API Level 19 or higher.
    Other Settings > Scripting Backend Pilih IL2CPP, bukan Mono, untuk mengizinkan dukungan ARM64 diaktifkan di langkah berikutnya.

    Selama pengembangan:

    • Gunakan Mono + 32-bit (ARMv7)
    • Menginstal APK ARCore FAT (32-bit + 64-bit)

    Saat melakukan pengiriman ke Play Store:

    • Gunakan IL2CPP
    • Aktifkan 32-bit (ARMv7) dan 64-bit (ARM64) untuk memenuhi persyaratan 64-bit Play Store
    • Opsional (didukung pada versi 2018.3+): Di Build Settings, aktifkan Android App Bundles
    Other Settings > Target Architectures Untuk memenuhi persyaratan 64-bit Google Play, aktifkan ARM64 (ARM 64-bit). Biarkan ARMv7 (ARM 32 bit) diaktifkan untuk mendukung perangkat 32 bit.

iOS

  1. Buka File > Build Settings untuk membuka jendela Build Settings.
  2. Di bagian Platform, pilih iOS lalu klik Switch Platform.
  3. Klik Player Settings.
  4. Konfigurasikan setelan berikut:

    Player Settings > … Nilai
    Other Settings > Bundle Identifier Tambahkan nama aplikasi Anda dalam format DNS terbalik.
    Misalnya, gunakan com.mycompany.myapp.
    Other Settings > Camera usage description Masukkan deskripsi untuk menjelaskan penggunaan AR Anda (misalnya, ARKit).
    Other Settings > Target minimum iOS version 11.0 atau lebih tinggi
    Other Settings > Architecture ARM64

Langkah berikutnya