Memulai AR Foundation

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

Paket Ekstensi ARCore untuk AR Foundation opsional ARCore menambahkan fungsi tambahan, sehingga Anda dapat menggunakan fitur seperti Cloud Anchors, filter konfigurasi Kamera, serta Perekaman dan Pemutaran ke aplikasi Anda.

Memigrasi atau mengupgrade project yang sudah ada

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

Persyaratan

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

Android

Perangkat Keras

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

Software

iOS

Perangkat Keras

Software

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 menampilkan antarmuka yang dapat digunakan developer Unity, tetapi tidak mengimplementasikan fitur AR apa pun. Untuk menggunakan AR Foundation pada perangkat target, Anda juga harus menginstal paket terpisah dan mengaktifkan plugin yang sesuai untuk setiap platform.

Android

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

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

  2. Di samping Packages, pilih Unity Registry.

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

  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 jika aplikasi Anda menargetkan perangkat iOS. Gunakan versi yang sama dengan paket AR Foundation untuk menghindari masalah kompatibilitas.

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

  2. Di samping Packages, pilih Unity Registry.

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

  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

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

AR Foundation 4.x

  • 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. Class ini akan diganti dengan AR Camera baru di AR Session Origin.

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

AR Foundation 5.x

  • AR Session: Mengontrol siklus proses pengalaman AR.

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

Sebelum menambahkan objek game baru, hapus Main Camera default. Class ini akan diganti dengan AR Camera baru di XR Origin.

Tambahkan objek game AR baru ke scene: klik kanan panel Hierarchy, lalu pilih XR. Tambahkan AR Session baru dan objek game XR 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 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 membuat aplikasi yang Diperlukan AR, tentukan Android 7.0 'Nougat' (API Level 24) or higher.
    Jika Anda mem-build aplikasi AR Optional, 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:

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

    Saat mengirim ke Play Store:

    • Gunakan IL2CPP
    • Mengaktifkan 32-bit (ARMv7) dan 64-bit (ARM64) untuk memenuhi persyaratan Play Store 64-bit
    • Opsional (didukung di 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) tetap aktif 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 oleh Anda (misalnya, ARKit).
    Other Settings > Target minimum iOS version 11.0 atau lebih tinggi
    Other Settings > Architecture ARM64

Langkah berikutnya