Table of Contents

Membuat dan mengunggah anotasi dengan Unity Editor

Artikel ini memperkenalkan cara membuat dan mengunggah anotasi dengan Mega Studio di Unity Editor.

Sebelum memulai

Kiat

Plugin Mega sudah menambahkan dependensi pada com.unity.cloud.gltfast, sehingga Anda dapat langsung menyeret file model ke Unity Assets.

Mengapa anotasi diperlukan

EasyAR Mega Annotation (EMA) dapat digunakan untuk menyinkronkan posisi spasial lintas platform dengan definisi sistem koordinat yang berbeda.

Unity

Sistem koordinat lokal anotasi di lingkungan Unity: arah positif X menghadap ke belakang, arah positif Y menghadap ke atas, dan arah positif Z menghadap ke kanan.

xr-frame

Sistem koordinat lokal anotasi di lingkungan xr-frame: arah positif X menghadap ke belakang, arah positif Y menghadap ke atas, dan arah positif Z menghadap ke kiri.

Perbedaan arah di atas berasal dari definisi sistem koordinat yang berbeda yang digunakan oleh Unity dan xr-frame (sistem tangan kiri/tangan kanan).

Menggunakan EMA untuk menyinkronkan posisi spasial memiliki keunggulan signifikan berikut:

  1. Menyederhanakan proses pengembangan: secara otomatis menangani konversi koordinat lintas platform, menghindari logika rumit dan potensi kesalahan dari perhitungan manual.
  2. Meningkatkan efisiensi debugging: dapat dimuat langsung di MegaToolbox, sehingga memudahkan pengujian perangkat nyata dan verifikasi data dengan cepat.

Langkah operasi

  1. Membuat alat anotasi

    Klik kanan di panel Hierarchy Unity, lalu pilih EasyAR Mega > Tool > Annotation Tool (Edit Mode) secara berurutan.

    annotation

    Setelah pembuatan selesai, dua node EasyAR.Mega.Annotation dan MegaBlocks akan dibuat di scene.

    Pilih node EasyAR.Mega.Annotation. Kotak input username/email dan password akan muncul di panel Inspector.

    annotation

  2. Masuk ke akun

    Masukkan akun EasyAR dan password, lalu klik login. Jika berhasil, alat Studio akan muncul di panel Inspector.

  3. Memilih database cloud localization Mega

    Klik ikon di sisi kanan Mega Cloud Service.

    annotation

    Pilih database yang akan digunakan.

    annotation

    Setelah database localization dan informasi Mega Blocks berhasil dimuat, panel alat Studio akan terlihat seperti gambar.

    annotation

  4. Memuat model dense Block

    Klik Load di sisi kanan nama Block untuk memuat model dense Block tersebut secara dinamis.

    annotation

    Setelah model selesai dimuat, model akan muncul di tab Scene. Perhatikan bahwa saat indikator seperti pada gambar muncul di kiri bawah, model dalam tampilan saat ini belum selesai dimuat. Tunggu sebentar hingga indikator hilang, yang berarti pemuatan selesai.

    annotation

  5. Membuat anotasi

    Di scene, tahan tombol Ctrl (Windows) / Command (Mac), lalu klik kiri pada lokasi yang perlu diberi anotasi.

  6. Menggunakan model

    Seret model yang diimpor ke node scene sebagai child node dari anotasi.

    Ubah semua nilai Position dan Rotation pada panel Inspector model menjadi 0. Scale dapat disesuaikan sesuai kebutuhan.

    Catatan

    EMA memuat semua logika transformasi koordinat. Mengatur Position dan Rotation model menjadi 0 bertujuan agar pusat geometris model sepenuhnya berimpit dengan titik anotasi. Semua penyesuaian translasi dan rotasi harus dilakukan dengan mengoperasikan parent node-nya, yaitu node anotasi.

    annotation

  7. [Opsional] Menyesuaikan posisi model secara presisi

    Jika perlu menyesuaikan posisi dan arah model secara presisi, lihat cara menggunakan Unity editor untuk menyelaraskan konten 3D dengan scene nyata secara presisi.

  8. Membuat paket data anotasi

    Klik ikon di sisi kanan paket data anotasi pada panel Inspector.

    annotation

    Masukkan nama data anotasi di kotak, lalu klik tanda centang di kanan.

    annotation

    Setelah berhasil dibuat, tampilannya seperti gambar. Kemudian klik Confirm di bawah.

    annotation

    Klik ikon upload untuk meng-upload.

    annotation

    Prompt akan muncul setelah upload berhasil.

    annotation

  9. Mencatat ID anotasi

    Anda perlu mencatat nama atau ID data anotasi untuk memuat data anotasi yang sesuai di xr-frame.

    annotation

    Setelah upload berhasil, Anda juga dapat melihat informasi terkait di database cloud localization.

    annotation

    Di sini Anda juga dapat melihat nama dan ID data anotasi yang di-upload.

    annotation

Langkah berikutnya

Topik terkait