Table of Contents

Menggunakan Contoh untuk Memulai Pengembangan EasyAR Mega Unity dengan Cepat

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

开始之前

Sebelum membaca artikel ini, pastikan Anda telah menyelesaikan:

  • Memiliki pustaka lokalisasi cloud yang valid.
  • Menginstal Unity (2021.3.30 LTS atau versi yang lebih tinggi). Disarankan menggunakan Unity 2022.3 atau versi terbaru dari Unity 6.3.
  • Mengimpor paket com.easyar.sense-**.tgz dan com.easyar.mega-**.tgz sesuai dengan cara mengaktifkan Mega.
Catatan

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

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.

Import Sample

[!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: Mengkonfigurasi SDK dan Layanan Pemetaan Mega Cloud

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

  2. Tempelkan License Key Anda di panel Project Settings yang terbuka;
    Fill License

    Kiat

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

    • Buat EasyAR Sense 4.x Personal Edition
    • Pilih Tidak untuk peta ruang jarang
    • Isi nama aplikasi sesuka hati, isi com.mycompany.myproject untuk Bundle ID dan Package Name
    • Pilih License yang baru dibuat, masuk ke halaman tersebut dan klik tombol salin di sebelah kanan

    copykey

    Catatan

    Bundle ID dan Package Name dapat diubah nanti, tetapi jumlahnya terbatas. Jika Anda memiliki nama paket aplikasi yang jelas, Anda juga dapat mengisinya dengan nama paket Anda sendiri.

    Tidak ada batasan jumlah pembuatan versi personal, jenis lain dapat dibuat sesuai kebutuhan saat digunakan secara resmi.

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

  4. Konfigurasikan setiap informasi dari pustaka pemetaan Mega Cloud Anda ke item Mega Block di panel Project Settings;
    Mega Config Guide

    Kiat

    Konfigurasi pustaka pemetaan Mega Cloud dapat diperoleh dari Pusat Pengembangan EasyAR.
    Mega Config Detail
    Pastikan API Key Anda memiliki izin Mega Block dan SpatialMap, jika tidak, Anda perlu mengubahnya atau membuat ulang.
    API Key Auth
    Jika tidak dapat menemukan pustaka pemetaan, Anda perlu mengkonfigurasi pustaka pemetaan dengan benar, dan periksa lagi pustaka pemetaan cloud yang valid.

Langkah Ketiga: Konfigurasikan Mega Block

  1. Konfigurasikan Mega Block;

    Pilih Mega Block dan isi ID dan Nama Block.

    Kiat

    ID dan Nama Block dapat diambil dari pusat pengembangan EasyAR pada pustaka lokalisasi yang sesuai.

    Jika tidak ada data Block di pustaka lokalisasi, Anda perlu menambahkan Block yang diperlukan ke pustaka lokalisasi, dan periksa lagi pustaka lokalisasi cloud yang valid.

Langkah keempat: Menempatkan konten 3D

  1. Pilih Mega Block dan buat alat editor;

  2. Periksa informasi layanan dan hubungkan ke layanan;

    Kiat

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

    Setelah berhasil terhubung ke layanan, Anda seharusnya melihat waktu pembaruan dan antarmuka kontrol data editor Block.

  3. Muat data editor Block;

    Klik kotak pilihan pertama di bawah data Block, ini akan memulai proses pemuatan data editor Block. Setelah dimuat, Anda dapat melihat mesh Block saat ini di jendela Scene:

    Kiat

    Mesh Block akan berganti LOD berdasarkan posisi kamera, pastikan Anda terhubung ke internet.

  4. Tempatkan konten 3D

    Saat ini, Anda dapat menempatkan objek 3D dengan mengacu pada mesh Block.

    Catatan
    • Objek 3D harus ditempatkan di bawah node Block untuk memastikan posisi rendering konten virtual saat runtime benar.
    • Objek 3D tidak boleh ditempatkan di bawah node EasyAR.Mega.EditorTool, node ini hanya digunakan untuk alat editor dan dalam beberapa kasus akan dihapus atau dibuat ulang secara otomatis.

Langkah Kelima: Mengubah Konfigurasi Player

Berurutan di menu Unity File > Build Settings > Player Settings, klik ikon Android, kemudian buka pengaturan yang sesuai untuk 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 Anda harus mengisi Package Name di sini dengan com.mycompany.myproject, jika tidak, aplikasi akan gagal berjalan.

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

    androidAPILevel

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

    androidarm64

Langkah keenam: Bangun dan jalankan

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

Efek jalankan dari rekaman langsung di lapangan adalah sebagai berikut:

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:

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

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

Kontrol Presisi Fitur Mega

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

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

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:

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