Table of Contents

Penggunaan contoh cepat memulai pengembangan EasyAR Unity

Tutorial ini memperkenalkan cara mengkonfigurasi dan menjalankan contoh EasyAR Unity untuk memulai pengembangan AR dengan cepat.

Mempersiapkan proyek Unity kosong

Pastikan versi Unity yang kompatibel sudah terpasang (Unity 2021.3 atau lebih tinggi). Disarankan menggunakan versi terbaru Unity 2022.3 atau Unity 6.3.

Buat proyek Unity kosong menggunakan template 3D (Built-in Render Pipeline):

Catatan

Tidak disarankan menggunakan URP untuk penggunaan pertama.

Jika Anda menggunakan Unity 6, Anda perlu mengunduh dan menggunakan 3D (Built-In Render Pipeline) Template secara manual. Pada instalasi default, template ini berada di posisi yang agak ke bawah dalam daftar template.

Penting

Untuk menggunakan URP, konfigurasi tambahan HARUS dilakukan sesuai petunjuk di Universal Render Pipeline (URP), jika tidak, gambar kamera tidak akan ditampilkan.

Mengimpor easyar sense unity plugin

  • Unduh paket plugin
    • Unduh versi terbaru EasyAR Sense Unity Plugin yang mencakup sampel (sample).
    • Setelah mengekstrak paket zip, Anda akan melihat readme dan file .tgz. File .tgz dapat langsung diimpor ke Unity dan tidak boleh diekstrak.
    • Simpan file .tgz di folder Packages proyek Unity Anda.
  • Impor paket plugin
    • Dari menu, klik Window lalu pilih Package Manager.
    • Di jendela yang muncul, klik tanda + di kiri atas dan pilih Install Package from tarball....
    • Pada dialog, pilih file .tgz yang telah disiapkan sebelumnya.

ImportUnityPlugin

Catatan

File .tgz tidak boleh dihapus atau dipindahkan setelah diimpor ke Unity. Pastikan menyimpan file ini di lokasi yang tepat sebelum impor. Biasanya disarankan menyimpannya di folder Packages proyek Unity untuk memudahkan manajemen versi.

Impor contoh

Buka Package Manager menggunakan menu Window > Package Manager, pilih EasyAR Sense Unity Plugin, lalu di sebelah kanan pilih **All Samples** untuk mengimpor semua contoh sekaligus.

ImportSample

Hati-Hati

**All Samples** dan contoh lainnya tidak dapat diimpor bersamaan, jika tidak akan terjadi duplikat aset yang mengakibatkan hilangnya sebagian sumber daya adegan. Jika tidak sengaja mengimpor file duplikat, hapus dan impor ulang.

Memodifikasi daftar adegan

Buka Build Settings (atau Build Profiles),

Tambahkan adegan sampel dari proyek Unity ke Scene List di Build Settings atau Build Profiles, dan pindahkan adegan peluncur sampel (AllSamplesLauncher) ke posisi pertama di antara semua adegan.

Hati-Hati

Perhatikan untuk tidak menambahkan adegan headset berikut, karena dapat menyebabkan kegagalan pembuatan paket:

  • Combination_BasedOn_AppleVisionPro.rst
  • Combination_BasedOn_Xreal.rst

Mengisi kunci lisensi (License Key)

Dari menu Unity, pilih EasyAR > Sense > Configuration untuk membuka antarmuka pengaturan EasyAR Sense.

FillInKey

Di kotak input di bawah EasyAR Sense License, masukkan Lisensi EasyAR Sense.

FillInKey2

Kiat

Lisensi EasyAR Sense dapat dibuat dari Pusat Pengembangan EasyAR (中文, English). Untuk penggunaan pertama, Anda dapat membuatnya dengan langkah-langkah berikut:

  • Buat EasyAR Sense 4.x Personal Edition
  • Untuk Sparse Spatial Map pilih Yes, isi nama sesuai keinginan
  • Isi nama aplikasi sesuai keinginan, untuk Bundle ID dan Package Name isi dengan com.mycompany.myproject
  • Pilih Lisensi yang baru dibuat, lalu klik tombol salin di sebelah kanan

copykey

Catatan

Bundle ID dan Package Name dapat diubah nanti, tetapi jumlah perubahannya terbatas. Jika Anda sudah memiliki nama paket aplikasi yang jelas, Anda juga dapat mengisi nama paket Anda sendiri.

Pembuatan edisi Personal tidak memiliki batasan jumlah. Tipe lainnya dapat dibuat sesuai kebutuhan saat penggunaan resmi.

Menjalankan di editor

Menjalankan di editor memerlukan kamera yang terhubung ke komputer Anda.

Pastikan kamera sistem berfungsi normal

Buka aplikasi kamera sistem:

Pastikan kamera dapat berfungsi normal:

Terakhir, pastikan untuk menutup aplikasi kamera guna menghindari konflik saat menjalankan contoh.

Catatan

EasyAR hanya menggunakan antarmuka yang disediakan sistem untuk membuka kamera. Pastikan aplikasi kamera sistem dapat membuka kamera dan menampilkan gambar secara normal.

Menjalankan contoh

Konten berikut menggunakan contoh pelacakan gambar ImageTracking_Targets sebagai referensi. Contoh lainnya dapat dijalankan dengan cara serupa.

Buka scene peluncur contoh, lalu klik tombol Play di bagian atas editor Unity.

Masuk ke scene ImageTracking_Targets.

Kiat

Anda juga dapat langsung membuka scene ImageTracking_Targets dan menjalankannya.

Arahkan kamera ke gambar target berikut:

namecard

Alamat unduh: 🔗 namecard

EasyAR akan mengenali dan melacak gambar ini, lalu menambahkan objek virtual.

Catatan

Beberapa fitur tidak dapat dijalankan dengan kamera di editor, tetapi dapat berfungsi di perangkat seluler. Contoh yang tidak dapat digunakan di editor akan menampilkan pesan error saat dijalankan.

Pesan peringatan dan log error juga akan ditampilkan.

Menjalankan di ponsel

Di ponsel perlu dikemas, sebelum dikemas perlu mengubah konfigurasi Player.

Modifikasi konfigurasi Player

Di menu Unity File > Build Settings > Player Settings, klik ikon Android untuk menampilkan pengaturan platform Android.

switchtoandroid

  • Ubah Package Name menjadi Package Name yang ditampilkan di halaman License Key

    androidPackageName

    Kiat

    Misalnya, jika Package Name yang Anda isi saat membuat License Key adalah com.mycompany.myproject, Anda harus mengisi Package Name di sini sebagai com.mycompany.myproject, jika tidak aplikasi akan gagal berjalan.

  • Ubah Minimum API Level menjadi API Level 21 atau versi yang lebih tinggi

    androidAPILevel

  • Ubah Scripting Backend menjadi IL2CPP, dan centang ARM64 di Target Architecture

    androidarm64

Membuat aplikasi

Pilih File > Build Settings, pilih platform target (Android/iOS), lalu pilih switch platform.

switchplatform

Pilih Build atau Build And Run untuk mengompilasi proyek dan menginstalnya di ponsel. Saat dijalankan, diperlukan untuk mengizinkan izin yang sesuai.

buildandrun

Contoh menjalankan

Konten berikut menggunakan contoh pelacakan gambar ImageTracking_Targets sebagai contoh. Contoh lainnya dapat dijalankan dengan cara serupa.

Setelah dijalankan, yang akan dimulai adalah adegan peluncur contoh.

Kiat

Jika tidak masuk ke adegan peluncur contoh setelah dibuka, periksa apakah daftar adegan Build Settings atau Build Profiles diatur dengan benar. Pindahkan AllSamplesLauncher ke urutan pertama.

Masuk ke adegan ImageTracking_Targets.

Arahkan kamera ponsel ke gambar pengenalan berikut:

namecard

Alamat unduhan: 🔗 namecard

EasyAR akan mengenali dan melacak gambar ini, lalu menambahkan objek virtual.

Langkah selanjutnya

Anda telah berhasil menjalankan sampel AR Unity, dan mungkin tertarik untuk mengetahui bagaimana adegan AR yang ditampilkan dalam sampel tersebut dibuat. Anda dapat membaca panduan pemula berikut secara berurutan:

Untuk peluncur sampel, Anda dapat merujuk ke petunjuk penggunaan terperinci:

Jika Anda ingin memahami konfigurasi proyek lengkap, Anda dapat merujuk ke konten berikut:

Jika Anda ingin mempelajari lebih lanjut tentang cara menggunakan EasyAR, Anda dapat memulai dari sini: