Memulai AR Foundation

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

Fitur opsional ARCore Ekstensi ARCore untuk AR Foundation paket menambahkan fungsi tambahan, memungkinkan Anda untuk menggunakan fitur seperti Cloud Anchor, filter konfigurasi Kamera, serta Perekaman dan Pemutaran ke .

Memigrasikan atau mengupgrade project yang sudah ada

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

Persyaratan

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

Android

Perangkat Keras

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

Software

iOS

Perangkat Keras

Software

Instal AR Foundation

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

  1. Buka project Unity yang sudah 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 untuk digunakan pengembang Unity, tetapi tidak menerapkan fitur AR itu sendiri. Untuk menggunakan AR Foundation pada target Anda juga perlu menginstal paket terpisah dan mengaktifkan {i>plugin<i} yang sesuai untuk setiap platform.

Android

Plugin ARCore XR memungkinkan Anda membangun 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 membangun 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

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

Dasar-Dasar AR 4.x

  • AR Session: Mengontrol siklus proses pengalaman AR.

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

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

Tambahkan objek game AR baru ke adegan Anda: klik kanan pada Panel Hierarchy, lalu pilih XR. Tambahkan AR Session baru dan AR Session Origin dalam game.

Dasar-Dasar AR 5.x

  • AR Session: Mengontrol siklus proses pengalaman AR.

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

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

Tambahkan objek game AR baru ke adegan Anda: klik kanan pada Panel Hierarchy, lalu pilih XR. Tambahkan AR Session baru dan XR Origin dalam game.

Mengonfigurasi Setelan Pemutar

Android

  1. Buka File > Build Settings untuk membuka Build Settings jendela.
  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 bawah Graphics APIs, hapus karena Vulkan belum didukung oleh ARCore.
    Other Settings > Package Name Buat ID aplikasi yang unik menggunakan format nama paket Java.
    Misalnya, gunakan com.example.helloAR.
    Other Settings > Minimum API Level Jika Anda membangun aplikasi yang Diperlukan AR, tentukan Android 7.0 'Nougat' (API Level 24) or higher.
    Jika Anda membangun aplikasi AR Optional, tentukan Android API Level 19 or higher.
    Other Settings > Scripting Backend Pilih IL2CPP, bukan Mono, untuk mengizinkan dukungan ARM64 diaktifkan pada langkah berikutnya.

    Selama pengembangan:

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

    Saat mengirim ke Play Store:

    • Gunakan IL2CPP
    • Aktifkan 32-bit (ARMv7) dan 64-bit (ARM64) untuk memenuhi persyaratan 64-bit Play Store
    • Opsional (didukung pada 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 Build Settings jendela.
  2. Di bagian Platform, pilih iOS lalu klik Switch Platform.
  3. Klik Player Settings.

  4. Konfigurasi 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 (misalnya, ARKit).
    Other Settings > Target minimum iOS version 11.0 atau lebih tinggi
    Other Settings > Architecture ARM64

Langkah berikutnya