Table of Contents

Mulai cepat pengembangan EasyAR Mega Unity dengan contoh

Tutorial ini menjelaskan cara mengonfigurasi dan menjalankan contoh EasyAR Mega Unity untuk memulai pengembangan EasyAR Mega dengan cepat.

Sebelum mulai

Sebelum membaca tutorial ini, pastikan Anda sudah menyelesaikan hal berikut:

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

Tutorial ini hanya berlaku untuk Unity plugin versi >= 4003. Jika Anda kebetulan mengunduh versi lama tetapi masih membaca dokumen pemula, Anda perlu mengunduh plugin versi terbaru terlebih dahulu.

Cara menggunakan contoh (enam langkah)

Di bawah ini, kami akan menjelaskan cara mengonfigurasi dan menjalankan contoh inti EasyAR Mega MegaBlock_Basic dalam enam langkah.

Langkah 1: Impor contoh

Catatan

Jika semua contoh sudah diimpor melalui **All Samples**, langkah ini dapat dilewati.

  1. Buka Package Manager melalui menu Window > Package Manager, pilih EasyAR Sense Unity Plugin, lalu perluas semua contoh di bagian Samples di sisi kanan.
  2. Pilih contoh, misalnya MegaBlock_Basic, lalu klik Import.

Import Sample

Catatan
  • Tutorial ini tidak bisa langsung diterapkan pada perangkat headset, tetapi sebelum mengembangkan untuk perangkat headset, Anda perlu memahami alurnya lewat pengembangan di ponsel.
  • Jika sebelumnya Anda sudah mengimpor contoh dari SDK versi lama, setelah upgrade SDK Anda perlu menghapus contoh lama terlebih dahulu lalu mengimpornya kembali.

Langkah 2: Konfigurasikan SDK dan layanan lokalisasi cloud Mega

  1. Pilih menu EasyAR > Sense > Configuration;
    License Guide

  2. Di panel Project Settings yang terbuka, tempelkan License Key Anda;
    Fill License

    Kiat

    EasyAR Sense License dapat dibuat dari EasyAR Development Center. Untuk penggunaan pertama, Anda dapat mengikuti langkah berikut:

    • Buat EasyAR Sense 4.x Personal
    • Pilih No untuk dense spatial mapping
    • Isi nama aplikasi sesuka Anda, lalu isi Bundle ID dan Package Name dengan com.mycompany.myproject
    • Pilih License yang baru dibuat, lalu klik tombol salin di sebelah kanan

    copykey

    Catatan

    Bundle ID dan Package Name masih bisa diubah nanti, tetapi jumlahnya terbatas. Jika Anda sudah memiliki nama package aplikasi yang pasti, Anda juga boleh langsung mengisi nama package sendiri.

    Pembuatan versi personal tidak dibatasi jumlahnya. Tipe lain dapat dibuat sesuai kebutuhan saat penggunaan resmi.

  3. Periksa dan aktifkan opsi Mega > Mega Block/Landmark support di panel Project Settings;

  4. Konfigurasikan informasi cloud positioning library Mega Anda pada item Mega Block di panel Project Settings;
    Mega Config Guide

    Kiat

    Konfigurasi cloud positioning library Mega dapat diambil dari EasyAR Development Center.
    Mega Config Detail
    Pastikan API Key Anda memiliki izin untuk Mega Block dan SpatialMap. Jika belum, Anda perlu mengubahnya atau membuat ulang.
    API Key Auth
    Jika library lokalisasi tidak ditemukan, Anda perlu mengonfigurasi library lokalisasi dengan benar terlebih dahulu, lalu periksa lagi bahwa cloud positioning library valid.

Langkah 3: Konfigurasikan Mega Block

  1. Konfigurasikan Mega Block;

    Pilih Mega Block dan isi ID serta Name block.

    Kiat

    Block ID dan Name dapat diambil dari library lokalisasi terkait di EasyAR Development Center.

    Jika tidak ada data Block di library lokalisasi, Anda perlu menambahkan Block yang dibutuhkan ke library lokalisasi, lalu periksa lagi bahwa cloud positioning library valid.

Langkah 4: Menempatkan konten 3D

  1. Pilih Mega Block lalu buat editor tool;

  2. Periksa informasi layanan dan hubungkan ke layanan;

    Kiat

    Jika tidak ada perubahan lain, informasi layanan seharusnya sama dengan yang diisi di Project Settings.

    Setelah tersambung normal ke layanan, Anda akan melihat waktu pembaruan dan antarmuka kontrol data Block Editor.

  3. Muat data Block Editor;

    Klik kotak pilihan pertama di bawah data Block, ini akan memulai proses pemuatan data Block Editor. Setelah dimuat, mesh block saat ini akan terlihat di jendela Scene:

    Kiat

    Mesh Block akan berganti LOD sesuai posisi kamera, jadi koneksi internet harus tetap aktif.

  4. Tempatkan konten 3D

    Pada tahap ini, Anda bisa menempatkan objek 3D dengan merujuk mesh Block.

    Catatan
    • Objek 3D harus ditempatkan di bawah node Block agar posisi rendering konten virtual saat runtime tetap benar.
    • Objek 3D tidak boleh ditempatkan di bawah node EasyAR.Mega.EditorTool, karena node ini hanya untuk editor tool dan pada beberapa kondisi akan dihapus atau dibangun ulang secara otomatis.

Langkah 5: Ubah konfigurasi Player

Melalui menu Unity File > Build Settings > Player Settings, klik ikon Android untuk membuka 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, maka Package Name di sini juga harus com.mycompany.myproject, jika tidak maka eksekusi akan gagal.

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

    androidAPILevel

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

    androidarm64

Langkah 6: Build dan jalankan

  1. Tambahkan scene saat ini ke File > Build Settings atau Build Profiles > Scene List;
  2. Pindah ke platform target (misalnya Android / iOS), lalu periksa apakah package name (Bundle ID) cocok dengan License Key;
    Switch Platform
  3. Klik Build And Run.
    Build And Run

Berikut adalah hasil eksekusi dari rekaman langsung:

Tentang teks kuning di layar

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

  1. Pesan peringatan untuk simulasi

    Letaknya di bagian bawah layar:

    Peringatan ini muncul karena pada konfigurasi default, aplikasi dapat dijalankan tanpa berada di lokasi sebenarnya. Ini hanya sedikit memengaruhi hasil aplikasi. Jika Anda memang menggunakan perangkat di lokasi sebenarnya, Anda bisa mengubah konfigurasi MegaTracker sebelum build.

  2. Informasi diagnostik

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

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

Langkah berikutnya: dari pemula ke mahir

Selamat! Dengan langkah-langkah di atas, Anda telah berhasil menjalankan contoh inti EasyAR Mega dalam 10 menit, dan merasakan langsung pesona lokalisasi spasial serta overlay konten AR.

Sekarang Anda sudah menguasai dasarnya. Jika Anda ingin:

  • Membangun aplikasi AR yang lebih stabil dan efisien
  • Mewujudkan efek occlusion nyata-virtual, alignment konten, dan lainnya
  • Melakukan debugging saat tidak memiliki perangkat atau tidak dapat pergi ke lokasi

Silakan merujuk ke panduan mendalam berikut, yang akan membantu Anda menyelesaikan masalah nyata selama proses pengembangan.

Pengembangan lanjutan

Jika Anda ingin memahami konfigurasi proyek secara lengkap, silakan lihat:

Jika Anda ingin mengenal penggunaan EasyAR lebih lanjut, mulailah dari sini:

Selain itu, disarankan membaca hal berikut untuk membantu pengembangan dan debugging:

Kontrol halus fitur Mega

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

Konten berikut akan membantu Anda memverifikasi fitur Mega tanpa perlu datang ke lokasi:

Topik lanjutan

Konten berikut lebih cocok dibaca setelah Anda memiliki cukup pengalaman menggunakan EasyAR.

Jika Anda ingin menjalankan EasyAR Mega di headset, silakan lihat:

Jika Anda ingin menggunakan AR Foundation, mulailah dari sini: