Penggunaan contoh cepat memulai pengembangan EasyAR Mega Unity

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

Sebelum memulai

Sebelum membaca bagian ini, pastikan Anda telah menyelesaikan:

• Memiliki library lokalisasi cloud yang valid.
• Menginstal Unity (2021.3.30 LTS atau versi lebih baru), disarankan menggunakan versi terbaru Unity 2022.3 atau Unity 6.3.
• Mengimpor paket com.easyar.sense-**.tgz dan com.easyar.mega-**.tgz sesuai metode Mengaktifkan Mega.

Contoh penggunaan (enam langkah)

Di bawah ini akan dijelaskan enam langkah untuk mengonfigurasi dan menjalankan contoh inti EasyAR Mega, yaitu MegaBlock_Basic.

Langkah pertama: Mengimpor sampel

[!CATATAN] Jika semua sampel diimpor melalui **All Samples**, lewati langkah ini.

1. Gunakan menu Jendela > Manajer Paket untuk membuka Package Manager, pilih EasyAR Sense Unity Plugin, di bagian Samples sebelah kanan, perluas semua sampel.
2. Pilih sampel (contoh: MegaBlock_Basic), klik Import.

[!CATATAN]

• Tutorial ini tidak dapat langsung diterapkan pada perangkat head-mounted, tetapi sebelum mengembangkan untuk perangkat head-mounted, Anda perlu memahami alur pengembangan menggunakan ponsel.
• Jika Anda sebelumnya telah mengimpor sampel dari versi SDK lama, setelah meningkatkan SDK, hapus dulu sampel lama sebelum mengimpor ulang.

Langkah kedua: Isi license key dan konfigurasikan layanan lokasi cloud mega

1. Di menu, pilih EasyAR > Sense > Configuration;
   
2. Tempel License Key Anda di panel Project Settings yang terbuka;
   

Kiat

EasyAR Sense License dapat dibuat dari EasyAR Development Center. Untuk pertama kali, Anda dapat membuatnya dengan langkah berikut:

• Buat EasyAR Sense 4.x Personal
• Pilih Tidak untuk sparse spatial map
• Isi nama aplikasi bebas, Bundle ID dan Package Name isi dengan com.mycompany.myproject
• Pilih lisensi yang baru dibuat, lalu klik tombol salin di sebelah kanan

Catatan

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

Lisensi personal dapat dibuat tanpa batasan jumlah. Jenis lainnya dapat dibuat sesuai kebutuhan saat penggunaan resmi.

3. Konfigurasikan informasi library lokasi cloud Mega Anda ke item Mega Block di panel Project Settings;
   

Kiat

Konfigurasi library lokasi cloud Mega dapat diperoleh dari EasyAR Development Center.

Pastikan API Key Anda memiliki izin untuk Mega Block. Jika tidak, perlu diubah atau dibuat ulang.

Langkah ketiga: Penempatan konten 3d

1. Klik kanan di area kosong panel Hierachy, tambahkan alat penampil Block (Pengembangan Unity);
   

2. Akses layanan pelokasian Mega;

   1. Pilih node EasyAR.Mega.BlockViewer (Dev), di panel Inspector isi informasi akun EasyAR Anda dan login;
      
   2. Klik tombol di sebelah kanan Mega Cloud Service;
      
   3. Pilih Layanan pelokasian Mega yang ingin Anda gunakan, klik OK.
      

3. Muat Block

   Setelah memilih layanan, daftar Block di perpustakaan saat ini akan ditampilkan di bawah node MegaBlocks, dan ditampilkan di panel alat. Klik Muat untuk memilih Block:
   

   Setelah pemuatan selesai, Block akan ditampilkan di jendela Scene. Anda dapat beroperasi di jendela Scene, sesuaikan sudut pandang dan posisi tampilan. Periksa juga apakah file Block dapat digunakan (misalnya, apakah sistem koordinat Block normal, apakah ada lapisan, apakah terlalu buram atau rusak sehingga tidak dapat menemukan posisi untuk menempatkan sumber daya AR, dll.).
   

4. Tempatkan konten 3d

   Pada titik ini, Anda dapat merujuk ke Block untuk menempatkan objek 3D.
   

   [!CATATAN]

   • Objek 3D harus ditempatkan di bawah node MegaBlocks > Block_* yang dihasilkan secara otomatis oleh alat, untuk memastikan posisi rendering konten virtual benar saat runtime.
   • Jangan ubah nama node Block_* dan local transform, ini dikelola secara otomatis oleh alat.

Langkah keempat: Konfigurasi MegaTracker

1. Konfigurasi Block Root;

   Luaskan AR Session, pilih Mega Block Tracker dan set Block Root ke node MegaBlocks yang dihasilkan oleh alat.
   

Langkah kelima: modifikasi konfigurasi Player

• Android
• iOS

Pergi ke menu Unity File > Build Settings > Player Settings, klik ikon Android untuk membuka pengaturan platform Android.

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

  

  Kiat

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

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

  

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

  

Langkah keenam: Bangun dan jalankan

1. Tambahkan scene saat ini ke File > Build Settings atau Build Profiles > Scene List;
2. Beralih ke platform target (misalnya Android/iOS), periksa apakah nama paket (Bundle ID) dan License Key sudah sesuai;
   
3. Klik Build And Run.
   

Berikut adalah efek operasi yang direkam langsung di lokasi:

Tentang teks kuning di layar

Saat runtime, Anda mungkin melihat dua bagian teks kuning ditampilkan di layar.

1. Pesan peringatan untuk simulasi

   Letaknya di bagian bawah layar:

   

   Peringatan ini muncul karena dalam konfigurasi default, aplikasi dapat berjalan tanpa berada di lokasi. Ini sedikit memengaruhi kinerja aplikasi. Jika Anda kebetulan menggunakan di lokasi, Anda dapat mengubah konfigurasi MegaTracker sebelum membangun aplikasi.

2. Informasi diagnostik

   Letaknya di bagian atas layar, digunakan untuk memahami status operasi dan masalah session. Disarankan untuk tetap menampilkannya selama tahap pengembangan dan pengujian:

   

   Anda dapat merujuk ke Informasi diagnostik dalam scene untuk memahami cara mengonfigurasi dan menggunakan informasi diagnostik ini dengan cepat.

Langkah selanjutnya: dari pemula hingga mahir

Selamat! Melalui langkah-langkah di atas, Anda telah berhasil menjalankan contoh inti EasyAR Mega dalam 10 menit, merasakan secara langsung pesona pelacakan spasial dan penempatan konten AR.

Sekarang, Anda telah menguasai dasar-dasarnya. Jika Anda ingin:

• Membangun aplikasi AR yang lebih stabil dan efisien
• Mencapai efek kompleks seperti oklusi realitas-virtual, penyelarasan konten, dll.
• Melakukan debug saat tidak memiliki perangkat atau tidak dapat ke lokasi

Silakan merujuk ke panduan mendalam berikut ini. Mereka akan membantu Anda menyelesaikan masalah praktis selama pengembangan.

Pengembangan lanjutan

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

• Menggunakan Universal Render Pipeline (URP)
• Pengaturan player
• Konfigurasi EasyAR

Jika Anda ingin memahami lebih lanjut cara penggunaan EasyAR, Anda dapat memulai dari sini:

• Dasar aplikasi Unity berbasis AR

Sekaligus, disarankan membaca konten berikut untuk membantu pengembangan dan debugging:

• Diagnosis dan pelaporan masalah dalam pengembangan Unity
• Simulasi operasi AR di Unity

Kontrol Presisi Fitur Mega

Konten di bawah ini akan membantu Anda menggunakan Mega dengan lebih baik di aplikasi Anda:

• Penggunaan di lokasi dan simulasi
• Praktik terbaik ARSession
• Menambahkan target pelacakan
• Membuat konten 3D yang selaras dengan dunia nyata
• Oklusi lingkungan (Occlusion)
• Mengontrol proses pelacakan

Konten di bawah ini akan membantu Anda memverifikasi fungsi Mega tanpa perlu ke lokasi:

• Verifikasi cepat menggunakan kamera PC
• Simulasi menggunakan alat verifikasi Session

Topik lanjutan

Konten di bawah ini lebih cocok dibaca setelah memiliki pengalaman menggunakan EasyAR.

Jika Anda ingin menjalankan EasyAR Mega di headset, Anda dapat merujuk ke konten berikut:

• Dukungan headset EasyAR di Unity
• Menggunakan sampel EasyAR di headset atau kacamata XR

Jika Anda ingin menggunakan AR Foundation, Anda dapat memulai dari sini:

• Dukungan EasyAR untuk framework XR Unity