Menggunakan AllSamplesLauncher untuk pengalaman cepat sampel EasyAR

AllSamplesLauncher adalah peluncur sampel terintegrasi yang membantu Anda mengenal berbagai fitur EasyAR SDK dengan cepat. Melalui peluncur ini, Anda dapat beralih dan menjalankan semua adegan sampel resmi dalam satu proyek Unity dengan satu klik, tanpa perlu mengkonfigurasi beberapa proyek secara manual.

Persiapan

Sebelum memulai, pastikan Anda telah menyelesaikan persiapan berikut:

1. Sudah menginstal Unity Hub dan editor Unity
2. Membuat proyek Unity baru
3. Sudah mengimpor EasyAR Sense Unity Plugin dan mengimpor semua Samples

Silakan merujuk ke pengenalan di panduan memulai cepat untuk langkah-langkah operasional.

Langkah-langkah detail

1. Buka semua adegan dalam Samples.
   
2. Klik menu File > Build Settings atau Build Profiles > Scene List.
3. Seret semua adegan ke dalam Scene List.
4. Pastikan AllSamplesLauncher berada di urutan pertama dari semua adegan. Jika tidak, Anda dapat menyeretnya di dalam jendela.
   
5. Klik menu File > Build And Run untuk membangun paket dan menjalankan.

[!CATATAN]
Saat membangun paket untuk dijalankan di ponsel, jangan tambahkan adegan kelas headset:

• Combination_BasedOn_AppleVisionPro
• Combination_BasedOn_Xreal
  

Masalah dalam pembuatan paket

Dalam proses kompilasi dan pembuatan paket, Anda mungkin mengalami beberapa kesalahan. Masalah umum meliputi:

Informasi Kesalahan	Penyebab	Solusi
FileNotFoundException:EasyAR Settings Asset	Lisensi belum diisi	Klik menu EasyAR > Sense > Configuration, di EasyAR Sense License isi License Key Anda
Missing Prefab Asset: 'XR Interaction Setup'	File terkait headset hilang	Hapus adegan terkait headset dari daftar adegan pembuatan paket. Jika Anda yakin perlu membuat paket headset, ikuti langkah-langkah di penggunaan sampel headset

Penggunaan peluncur

Setelah dijalankan, Anda akan melihat antarmuka peluncur yang sederhana.

Klik tombol Samples di tengah bawah antarmuka untuk memasuki semua sampel fitur.

Di sisi kiri antarmuka adalah klasifikasi fungsi, di sisi kanan adalah daftar sampel adegan di bawah setiap fungsi. Klik pada adegan sampel yang berbeda untuk mencoba semua fungsi berbeda yang disediakan EasyAR.

Di bagian bawah antarmuka juga disediakan demonstrasi video fungsi EasyAR Sense dan EasyAR Mega, yang dapat membantu Anda lebih memahami fungsi dan efek apa yang dapat diberikan EasyAR kepada Anda.

Hal-hal yang harus dibaca sebelum menjalankan sampel

Sebelum menjalankan sampel tertentu, Anda harus menyelesaikan konfigurasi kunci berikut, jika tidak sampel tidak akan berfungsi dengan baik:

1. Atur API Key Anda

   • Beberapa sampel (terutama yang melibatkan pengenalan awan, pelokalan awan Mega, dll.) memerlukan API Key yang valid.
   • Di menu EasyAR > Sense > Configuration, temukan tempat yang perlu diisi untuk sampel yang sesuai.
   • Isi App ID, API Key, API Secret yang Anda peroleh dari pusat pengembang EasyAR.
     
   • Penting: Jika Anda belum memiliki API Key, beberapa sampel fungsi lokal (seperti pelacakan gambar) mungkin masih dapat berjalan, tetapi fungsi awan akan gagal. Silakan kunjungi Pusat Pengembang EasyAR untuk membuat aplikasi dan mendapatkan Key.

2. Konfigurasi dukungan XR/platform:

   • Jika Anda menjalankan sampel terkait headset, ikuti langkah-langkah di penggunaan sampel headset.
   • Pastikan perangkat Anda (seperti ponsel atau headset) terhubung dengan benar dan dalam mode pengembang.

Menjelajahi sampel secara mendalam

Peluncur sampel adalah titik awal terbaik untuk belajar Anda. Kami sangat menyarankan Anda:

• Jalankan terlebih dahulu, baru pelajari: Dengan peluncur, alami efek setiap sampel dengan cepat untuk membangun kesan intuitif tentang kemampuan EasyAR.
• Buka file sumber adegan: Setiap sampel adalah file adegan Unity independen, terletak di direktori Assets/Samples/EasyAR Sense Unity Plugin/[versi]/__All Samples__/[nama fungsi]/[nama sampel]/Scenes.
• Pelajari dan baca kode skrip: Dalam adegan sampel, Anda dapat membuka skrip *.cs yang disertakan dengan sampel untuk melihat bagaimana kami memanggil API EasyAR untuk mengimplementasikan fungsi tertentu. Ini adalah cara terbaik untuk mempelajari metode penggunaan API.

Melalui peluncur sampel, Anda dapat membangun pemahaman tentang fungsi EasyAR SDK dengan cepat. Selamat menjelajah!