Memulai ARCore Extensions for AR Foundation

Paket Ekstensi ARCore opsional untuk AR Foundation menambahkan fungsionalitas ke paket AR Foundation Unity, sehingga Anda dapat menggunakan fitur seperti Cloud Anchors, filter konfigurasi kamera, dan Perekaman dan Pemutaran di aplikasi Anda.

Persyaratan

Untuk mengembangkan aplikasi dengan ARCore Extensions untuk AR Foundation, Anda memerlukan hal berikut:

Android

Perangkat Keras

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

Software

• Unity 2019.4.3f1 atau yang lebih baru dengan Dukungan Build Android
• AR Foundation 4.1.5 atau yang lebih baru (otomatis diinstal dengan ARCore Extensions for AR Foundation SDK)
• Plugin ARCore XR 4.1.5 atau yang lebih baru (otomatis diinstal dengan Ekstensi ARCore untuk AR Foundation SDK)

iOS

Perangkat Keras

• Perangkat yang didukung ARKit dan kompatibel dengan ARKit
• Kabel USB untuk menghubungkan perangkat ke mesin pengembangan

Software

• Unity 2019.4.3f1 atau yang lebih baru dengan Dukungan Build iOS
• AR Foundation 4.1.5 atau yang lebih baru (otomatis diinstal dengan ARCore Extensions for AR Foundation SDK)
• Plugin ARKit XR 4.1.5 atau yang lebih baru (otomatis diinstal dengan Ekstensi ARCore untuk AR Foundation SDK)
• Xcode 11.0 atau yang lebih baru

Menginstal paket ARCore Extensions

Ikuti langkah-langkah berikut untuk menginstal Ekstensi ARCore untuk AR Foundation.

Dependensi paket

1. Pastikan Anda telah menginstal dan mengonfigurasi AR Foundation di lingkungan pengembangan.
2. Buka atau buat project Unity baru.
3. Pilih platform build target yang diinginkan:
   1. Dari menu File, pilih Build Settings.
   2. Pilih Android atau iOS, bergantung pada platform target yang diinginkan.
   3. Klik Switch Platform.

4. Impor paket ARCore Extensions terbaru:

   1. Buka Window > Package Manager

   2. Klik tombol dan pilih opsi Add package from git URL... dari menu drop-down.
      

   3. Tempelkan URL berikut ke dalam kolom teks:

      https://github.com/google-ar/arcore-unity-extensions.git
      

   4. Klik Add.

Tanpa EDM4U

Secara default, Ekstensi ARCore dipaketkan dengan dependensi tambahan. Saat menggunakan library lain (misalnya, Firebase Analytics) yang bergantung pada versi External Dependency Manager for Unity yang berbeda, perilaku yang tidak ditentukan dapat terjadi, yang menyebabkan dependensi berhenti berfungsi dengan benar.

Instal Ekstensi ARCore tanpa dependensi yang dipaketkan untuk mencegah konflik pembuatan versi library:

1. Download Ekstensi ARCore tanpa rilis EDM4U dan com.google.external-dependency-manager,
2. Ikuti petunjuk cara mengimpor paket UPM dengan file .tgz, lalu menginstal paket dalam urutan berikut:
   1. com.google.external-dependency-manager,
   2. Ekstensi ARCore (tanpa EDM4U).

Saat menginstal ARCore Extensions, Unity juga akan otomatis menginstal versi dependensi yang diperlukan yang sesuai:

• AR Foundation
• ARCore XR Plugin (digunakan saat menargetkan Android)
• ARKit XR Plugin (digunakan saat menargetkan iOS)

Dependensi ini mungkin tidak terlihat dalam tampilan Package Manager > Package: In project. Namun, paket tersebut dapat dilihat di jendela Project di bagian Packages

Menyiapkan Ekstensi ARCore

AR Foundation 4.x

1. Di panel Hierarchy, klik kanan dan tambahkan objek game berikut (jika belum ditambahkan):

   • XR > AR Session
   • XR > AR Session Origin
   • XR > ARCore Extensions

2. Di panel Hierarchy, pilih paket ARCore Extensions.

3. Di panel Inspector, untuk setiap kolom berikut, klik tombol target, dan hubungkan setiap kolom dengan objek game yang sesuai, seperti berikut:

   • Session: Menggunakan AR Session scene.
   • AR Session Origin: Menggunakan AR Session Origin scene.
   • Camera Manager: Menggunakan AR Camera scene.

4. Jika ingin, buat dan hubungkan aset berikut untuk Cloud Anchors dan filter konfigurasi kamera.

   1. Di panel Project > Assets, klik kanan, pilih Create > XR > ARCore Extensions Config.

   2. Di panel Project > Assets, klik kanan, pilih Create > XR > Camera Config Filter.

   3. Di panel Hierarchy, pilih paket ARCore Extensions.

   4. Di kolom ARCore Extensions Config panel Inspector, klik tombol target, dan hubungkan ke aset ARCoreExtensionsConfig.

   5. Di kolom Camera Config Filter panel Inspector, klik tombol target, dan hubungkan ke aset ARCoreExtensionsCameraConfigFilter.

      Untuk mempelajari lebih lanjut, lihat panduan developer Cloud Anchor, dan panduan untuk Mengonfigurasi kamera.

   6. Jika Anda menggunakan versi Unity di bawah 2020.3:

      • Pilih Custom Gradle Properties Template di Project Settings > Player > Android > Publishing Settings > Build.

Dengan semua kolom Ekstensi ARCore di atas terhubung dengan tepat, panel Inspector Ekstensi ARCore Anda akan terlihat seperti ini:

AR Foundation 5.x

1. Di panel Hierarchy, klik kanan dan tambahkan objek game berikut (jika belum ditambahkan):

   • XR > AR Session
   • XR > XR Origin (Mobile AR)
   • XR > ARCore Extensions

2. Di panel Hierarchy, pilih paket ARCore Extensions.

3. Di panel Inspector, untuk setiap kolom berikut, klik tombol target, dan hubungkan setiap kolom dengan objek game yang sesuai, seperti berikut:

   • Session: Menggunakan AR Session scene.
   • XR Origin: Menggunakan XR Origin scene.
   • Camera Manager: Menggunakan AR Camera scene.

4. Jika ingin, buat dan hubungkan aset berikut untuk Cloud Anchors dan filter konfigurasi kamera.

   1. Di panel Project > Assets, klik kanan, pilih Create > XR > ARCore Extensions Config.

   2. Di panel Project > Assets, klik kanan, pilih Create > XR > Camera Config Filter.

   3. Di panel Hierarchy, pilih paket ARCore Extensions.

   4. Di kolom ARCore Extensions Config panel Inspector, klik tombol target, dan hubungkan ke aset ARCoreExtensionsConfig.

   5. Di kolom Camera Config Filter panel Inspector, klik tombol target, dan hubungkan ke aset ARCoreExtensionsCameraConfigFilter.

      Untuk mempelajari lebih lanjut, lihat panduan developer Cloud Anchor, dan panduan untuk Mengonfigurasi kamera.

   6. Jika Anda menggunakan versi Unity di bawah 2020.3:

      • Pilih Custom Gradle Properties Template di Project Settings > Player > Android > Publishing Settings > Build.

Dengan semua kolom Ekstensi ARCore di atas terhubung dengan tepat, panel Inspector Ekstensi ARCore Anda akan terlihat seperti ini:

Lihat panduan Unity tentang mengedit properti untuk mengetahui informasi selengkapnya tentang cara menyiapkan properti.

Project contoh

Dipaketkan dengan Ekstensi ARCore untuk AR Foundation adalah contoh project yang dapat Anda gunakan untuk mulai membuat project Anda sendiri.

1. Dari menu Window, buka Package Manager dan pilih paket ARCore Extensions.

2. Di bagian Samples, klik Import untuk project contoh, yang dijelaskan di bawah.

Project contoh berikut diimpor dari repositori GitHub:

• Geospatial (khusus Android) - Buat pengalaman AR dalam skala global, dan lampirkan konten dari jarak jauh ke area mana pun yang dicakup oleh Google Street View. Lihat pengantar Geospatial API untuk mengetahui informasi selengkapnya.

• PersistentCloudAnchors (Android dan iOS) - Ciptakan pengalaman AR yang persisten di dunia nyata dengan lapisan informasi digital interaktif yang dikaitkan ke lokasi sebenarnya, dan pengalaman desain yang dapat dibagikan dari waktu ke waktu oleh banyak orang di banyak perangkat yang berbeda. Lihat Pengantar Cloud Anchors untuk informasi selengkapnya.

Langkah selanjutnya

Dengan Ekstensi ARCore untuk AR Foundation, kini Anda dapat menggunakan Cloud Anchors dan konfigurasi kamera di aplikasi Anda.

• Panduan developer Cloud Anchors
• Panduan konfigurasi kamera