Mulai menggunakan Geospatial Creator untuk Unity

1. Sebelum memulai

Geospatial Creator, dengan teknologi ARCore dan Google Maps Platform, memungkinkan Anda menciptakan pengalaman augmented-reality (AR) di editor Unity. Geospatial Creator menggunakan Photorealistic 3D Tiles API Google untuk memberikan pratinjau tampilan pengalaman itu di dunia nyata tanpa perlu mengunjungi lokasi tersebut secara fisik.

Dalam codelab ini, Anda akan mulai menggunakan Geospatial Creator. Anda akan menemukan project Unity yang telah disiapkan sebagai panduan memulai dan mempelajari cara mengoperasikan editornya. Setelah itu, Anda akan mengimpor aset ke scene dan menempatkannya di dunia kembaran digitalnya. Anda akan menambahkan animasi ke aset untuk menjadikannya lebih hidup. Terakhir, Anda akan melihat konten tersebut di perangkat Anda sebagai AR.

Prasyarat

• Pengetahuan dasar tentang AR

Yang akan Anda pelajari

• Cara menyiapkan project ARCore Geospatial Creator di Unity.
• Cara membuka tampilan Scene.
• Cara menempatkan aset 3D dalam tampilan Scene.
• Cara menambahkan perilaku sederhana ke aset.
• Cara menjalankan pengalaman AR di perangkat.

Yang Anda butuhkan

• Penginstalan Unity Hub.
• Perangkat Android atau iOS yang didukung yang telah dikonfigurasi untuk pengembangan aplikasi.
• Untuk perangkat target Android, Android Studio yang telah diinstal dan dikonfigurasi untuk membangun aplikasi Android, serta Layanan Google Play untuk AR yang diinstal di perangkat pengembangan Android.
• Untuk perangkat target iOS, Xcode.

2. Menyiapkan lingkungan pengembangan

Untuk mengambil data Photorealistic 3D Tiles dari Google Cloud, Anda harus menyiapkan otorisasi.

Menyiapkan project Google Cloud

1. Buat project di Konsol Google Cloud.
2. Di kotak teks Project name, masukkan nama yang sesuai, misalnya ARCore Geospatial API project, lalu pilih sebuah lokasi.
3. Klik Create.
4. Di Konsol Google Cloud di halaman pemilih project, klik Create Project.

Mengaktifkan 3D Tiles API

Untuk mengaktifkan 3D Tiles API, klik tombol berikut, lalu pilih Enable:

Enable the 3D Tiles API

Mengaktifkan ARCore API

Untuk mengaktifkan ARCore API, klik tombol berikut, lalu pilih Enable:

Enable the ARCore API

Membuat kunci API untuk project

1. Di Konsol Google Cloud, di bagian APIs & services, pilih Credentials.
2. Di bagian atas halaman, klik Create Credentials, lalu pilih API Key.
3. Catat kunci ini karena Anda akan memerlukannya untuk langkah berikutnya.

Menyiapkan software

Untuk mulai menggunakan Geospatial Editor, ikuti langkah-langkah berikut:

1. Di Unity Hub, buat project 3D dengan Unity versi 2021.3.17f1 atau yang lebih baru.
2. Klik Window > Package Manager, lalu ikuti langkah-langkah berikut untuk menambahkan paket yang diperlukan:
   1. Klik + > Add package from git URL > https://github.com/google-ar/arcore-unity-extensions.git.
   2. Klik Samples, lalu impor sampel geospasial.
   3. Download the latest version of Cesium for Unity, lalu klik + > Add package from tarball > com.cesium.unity-1.0.0.tgz.
3. Jika software tersebut belum terinstal, ikuti langkah-langkah berikut untuk menginstal Shader Graph:
   1. Klik In Project > Unity Registry.
   2. Instal Shader Graph.

Menyiapkan contoh scene dengan objek ARCore

1. Di panel Project, klik Assets > Samples > ARCore Extensions > 1.37.0 > Geospatial Sample > Scenes > Geospatial.
2. Klik Layers, lalu nonaktifkan lapisan UI.
3. Klik Edit > Project Settings > XR Plug-in Management > ARCore Extensions.
4. Konfigurasi strategi otorisasi kunci API untuk platform target Anda.
5. Aktifkan fitur opsional Geospatial dan Geospatial Creator.
6. Di panel Hierarchy, klik + > XR > Geospatial Creator Origin.
7. Di panel Hierarchy, pilih AR Geospatial Creator Origin.
8. Di panel Inspector di bagian Geospatial Creator Origin, klik Add Cesium Georeference Component.
9. Di kotak teks Google Maps Tile API Key, masukkan kunci API, lalu tekan Enter (atau return di macOS).

3. Membuka tampilan Scene Unity

Pada langkah ini, Anda akan melihat representasi 3D area di sekitar Anda.

Mengubah lokasi tampilan 3D

Untuk mengubah lokasi pratinjau 3D Photorealistic Tiles ke sebuah area di dekat Anda, ikuti langkah-langkah berikut:

1. Di panel Hierarchy, pilih objek game AR Geospatial Creator Origin.
2. Di panel Inspector, ikuti langkah-langkah berikut untuk mengubah nilai Latitude dan Longitude ke sebuah lokasi di dekat Anda:
   1. Gunakan Google Maps untuk menemukan lokasi di dekat Anda.
   2. Klik kanan peta, lalu pilih koordinat yang tersedia untuk disalin ke papan klip.
      Setelah Anda mengubah nilai koordinat, representasi 3D dunia di jendela Scene akan berubah:
      

Mengontrol kamera area pandang

Untuk menemukan lokasi di sekitar tempat Anda ingin meletakkan konten yang ditambatkan secara geospasial, ikuti langkah-langkah berikut:

1. Gunakan tombol panah atas dan bawah untuk menggerakkan kamera maju dan mundur.
2. Gunakan tombol panah kiri dan kanan untuk menggeser tampilan.
3. Sambil menggerakkan, tekan dan tahan Shift untuk bergerak lebih cepat.
4. Jika Anda tersesat, di panel Hierarchy, pilih objek AR Geospatial Creator Origin, lalu tekan F untuk memusatkan kembali tampilan pada objek tersebut.

4. Mengimpor dan meletakkan aset 3D

Setelah menentukan lokasi di dekat Anda, sekarang Anda perlu mengimpor aset yang muncul di pengalaman AR, dan yang ditambatkan di dekat lokasi yang dipilih.

Mengimpor aset 3D

Untuk memudahkan Anda dalam codelab ini, kami telah menyiapkan contoh aset untuk digunakan dalam project Anda.

Untuk mengimpor contoh aset tersebut, ikuti langkah-langkah berikut:

1. Download the tiger asset.
2. Ekstrak arsip zip.
3. Klik Assets > Import new asset. Keempat aset akan diimpor ke dalam project Anda.
4. Di panel Project, tarik aset Tiger model ke panel Scene.

Mengubah ukuran dan memosisikan ulang aset

Untuk meletakkan aset di tempat yang tepat, ikuti langkah-langkah berikut:

1. Di panel Hierarchy, pastikan aset Tiger model sudah dipilih.
2. Di tampilan Scene, pastikan alat Scale sudah diaktifkan, lalu tarik kubus berwarna putih untuk menyesuaikan ukuran aset dengan preferensi Anda.
   
3. Di tampilan Scene, pastikan alat Move sudah diaktifkan, lalu pilih kontrol berwarna merah, biru, atau hijau, dan tarik mouse untuk mengubah posisi aset. Setiap kontrol berwarna mengunci dimensi tertentu dan memungkinkan Anda memindahkan objek di sepanjang sumbu itu.
   

Menambatkan aset secara geospasial

Untuk menambatkan konten Anda ke dunia nyata, ikuti langkah-langkah berikut:

1. Di panel Hierarchy, pastikan aset Tiger model sudah dipilih.
2. Di panel Inspector, tekan Add Component untuk menambahkan AR Geospatial Creator Anchor.

5. Menjadikan aset lebih hidup

Editor Unity memungkinkan Anda memprogram pengalaman AR yang menyenangkan dengan kecanggihan ekosistem Unity.

Untuk menggunakan salah satu animasi yang disediakan dalam project awal guna menganimasikan harimau sebagai loop, ikuti langkah-langkah berikut:

1. Di panel Hierarchy, pilih Tiger model.
2. Klik Add Component untuk menambahkan animator.
3. Di bagian Animator, pilih Controller, lalu gunakan aset Tiger idle animation controller yang disediakan.

6. Melihat aset sebagai AR

Terakhir, Anda akan melihat aset ini sebagai AR di perangkat Android atau iOS yang didukung ARCore.

Menjalankan aplikasi di perangkat

1. Klik File > Build Settings, lalu pilih platform build Android atau iOS.
2. Klik Switch platform.
3. Ikuti langkah tambahan untuk mengonfigurasi setelan pemutar.
4. Pastikan perangkat pengembangan Anda terhubung dan dikonfigurasi untuk pengembangan.
5. Klik Build and run.

7. Kesimpulan

Selamat! Anda telah mempelajari cara menggunakan Geospatial Creator di Unity untuk membuat pengalaman AR geospasial.

Mempelajari lebih lanjut

• Geospatial Creator untuk Unity di Google Developers