Menambahkan target pelacakan Mega

Dokumen ini menjelaskan cara menambahkan dan mengonfigurasi target pelacakan Mega.

Sebelum mulai

Periksa Apakah fungsi lokalisasi saya sudah siap? untuk memastikan library lokalisasi telah dibuat dengan benar dan peta telah ditambahkan.
Impor versi terbaru EasyAR plugin dan aktifkan fitur Mega
Pahami konsep dasar dan cara penggunaan target pelacakan Unity AR

Catatan

Konten dan alat berikut hanya berlaku untuk proses pengembangan aplikasi Unity menggunakan EasyAR Mega.

Jika Anda sedang mengembangkan mini program, silakan lihat membuat dan mengunggah annotation dengan Unity Editor (pengembangan mini program).

Jika Anda tidak sedang mengembangkan aplikasi Unity tetapi ingin melihat hasil mapping Mega, silakan lihat pratinjau 3D real-scene mesh pada panduan Mega.

Jika Anda tidak sedang mengembangkan aplikasi Unity tetapi perlu melihat efek lokalisasi dengan runtime simulasi, silakan lihat pratinjau hasil simulasi pada panduan Mega.

Dokumen ini memerlukan package Unity berikut sudah diimpor ke proyek:

Versi >= 4003
Versi 4.7 - 4002

com.easyar.sense

Target pelacakan Mega adalah objek kosong yang berisi komponen MegaBlockController, yang merepresentasikan sebuah block di Unity.

alt text

Catatan

Saat package com.easyar.mega belum diimpor, fungsi editor untuk block tidak dapat digunakan, tetapi tidak memengaruhi hasil dan fungsi tracking saat runtime.

Jika konfigurasi belum mengaktifkan fitur Mega dengan benar, fitur ini tidak dapat digunakan.

alt text

Membuat target pelacakan

Versi >= 4003
Versi 4.7 - 4002

Klik kanan pada area kosong di tampilan Hierarchy, lalu pilih menu EasyAR Sense > Mega > Target : Mega Block untuk membuat target pelacakan Mega.

alt text

Di script, Anda dapat membuatnya dengan ARSessionFactory.CreateController.

ARSessionFactory.CreateController<MegaBlockController>();

Menambahkan target pelacakan di editor

Metode ini memerlukan konfigurasi BlockHolder.BlockRootSource menjadi External (default) atau Mixed.

Pertama, tambahkan tool Block Viewer for Unity Developer.

Klik kanan pada area kosong di tampilan Hierarchy, lalu pilih menu EasyAR Mega > Tool > Block Viewer for Unity Developer (Edit Mode) untuk menambahkan tool Block Viewer khusus pengembangan Unity.

Penting

Saat mengembangkan aplikasi Mega di Unity, Anda harus menggunakan tool Block Viewer for Unity Developer. Tool lain di menu EasyAR Mega > Tool tidak cocok untuk pengembangan aplikasi Unity.

Walaupun Annotation Tool memiliki fungsi serupa, sebagian fiturnya akan dihapus pada versi mendatang, jadi tidak disarankan.

Fungsi anotasi dari Annotation Tool (hanya anotasinya) akan segera dipindahkan ke halaman web EasyAR Development Center, sementara pemuatan block mesh dan penempatan model tidak terpengaruh.

Setelah tool berhasil ditambahkan, hierarchy scene akan menampilkan node EasyAR.Mega.BlockViewer (Dev) dan node MegaBlocks.

Lalu gunakan tool tersebut untuk membuat target pelacakan.

Pilih node EasyAR.Mega.BlockViewer (Dev), lalu isi informasi akun EasyAR di panel Inspector dan masuk;

Klik tombol di kanan Mega Cloud Service;

Pilih Mega定位服务 yang ingin digunakan, lalu klik OK.

Setelah layanan dipilih, daftar block di library saat ini akan muncul di bawah node MegaBlocks dan juga pada panel tool.

Kiat

Mengapa MegaBlocks saya kosong?

Disarankan memeriksa Apakah fungsi lokalisasi saya sudah siap? untuk memastikan library lokalisasi telah dibuat dengan benar dan peta telah ditambahkan.

Sampai di sini, target pelacakan block sudah dibuat. Setiap child node yang diawali Block_ di bawah MegaBlocks merepresentasikan satu target pelacakan block.
Menambahkan target pelacakan secara otomatis saat lokalisasi berhasil

Metode ini memerlukan BlockHolder.BlockRootSource dikonfigurasi menjadi Internal atau Mixed.

Dalam kedua mode ini, jika sebuah block baru terlokalisasi dan block tersebut belum ada di bawah node BlockHolder.BlockRoot, block baru itu akan ditambahkan otomatis ke bawah node BlockHolder.BlockRoot. Jika BlockHolder.BlockRoot tidak ada, node tersebut akan dibuat otomatis.

Kiat

Saat target pelacakan ditambahkan otomatis setelah lokalisasi berhasil, model block tidak dapat dimuat, hanya target pelacakan block yang bisa ditambahkan.
Menambahkan target pelacakan di script

Metode ini memerlukan BlockHolder.BlockRootSource dikonfigurasi menjadi Internal atau Mixed. Pada kondisi ini, jika BlockHolder.BlockRoot tidak ada, node tersebut akan dibuat otomatis. Atau, Anda juga dapat menetapkan objek BlockHolder.BlockRoot terlebih dahulu di editor saat BlockHolder.BlockRootSource diatur ke External.

Catatan

Jika block tidak ada di library lokalisasi, maka meskipun ditambahkan ke scene melalui script, block tetap tidak bisa dilokalisasi.

Anda dapat menggunakan metode BlockHolder.Hold untuk menambahkan block baru ke bawah node BlockHolder.BlockRoot. Metode ini biasanya digunakan saat memakai file anotasi ema, ketika script membaca informasi anotasi lalu menambahkan block.

Misalnya, potongan kode berikut menunjukkan cara menambahkan block berdasarkan informasi di file anotasi:
```
foreach (var item in ema.blocks)
{
    var info = new BlockController.BlockInfo { ID = item.id.ToString(), Timestamp = item.timestamp };
    if (!item.keepTransform && item.location.OnSome)
    {
        blockHolder.Hold(info, item.location.Value);
    }
    else
    {
        blockHolder.Hold(info, item.transform.ToUnity());
    }
}
```
Kiat

Saat menambahkan target pelacakan lewat script pada runtime, model block tidak dapat dimuat, hanya target pelacakan block yang bisa ditambahkan.

Mengonfigurasi target pelacakan

Mengonfigurasi sumber data target

Versi >= 4003
Versi 4.7 - 4002

Target pelacakan hanya dapat dikenali dan dilacak setelah sumbernya dikonfigurasi dengan benar.

Di tampilan Hierarchy, Anda dapat memilih node block lalu mengisi ID dan Name block.

Di script, Anda dapat mengubah, sebelum MonoBehaviour.Start() pada komponen, Source untuk menetapkan sumber block.

block.Source = new MegaBlockController.BlockInfoSourceData(id, name);

Di sini

block id adalah identitas unik block, dan wajib diisi.
block name adalah nama block, dapat diisi bebas sesuai kebutuhan. Umumnya disarankan memakai nama asli block agar mudah dikenali.

Kiat

block id dan name dapat diambil dari library lokalisasi yang sesuai di EasyAR Development Center.

Jika di library lokalisasi belum ada data block, Anda perlu menambahkan Block yang dibutuhkan ke library lokalisasi, lalu memeriksa kembali validitas cloud positioning library.

Tentukan target yang digunakan, yaitu block, di MegaTrackerFrameFilter.

Dalam sebagian besar kasus, disarankan untuk mempertahankan konfigurasi default, yaitu mengimpor block lewat Mega Studio di editor.

Pilih objek Mega Tracker di bawah session, dan opsi Block Root Source sebaiknya tetap External (default).

Pada saat yang sama, Anda perlu menetapkan Block Root sebagai objek MegaBlocks di scene.

Mengubah opsi Block Root Source dapat menentukan cara sumber block lain, misalnya saat menggunakan data impor ema, biasanya dipilih opsi Internal atau Mixed.

Di script, Anda dapat mengubah BlockHolder.BlockRootSource untuk mendapatkan efek yang sama.

Mengonfigurasi tracker yang digunakan target

Versi >= 4003
Versi 4.7 - 4002

Target pelacakan akan dimuat oleh tracker yang dikonfigurasi dan dilacak setelah berhasil dilokalisasi.

Di tampilan Hierarchy, Anda dapat memilih node block lalu memilih Mega Tracker di session.

Di script, Anda dapat mengubah Tracker untuk menetapkan tracker bagi block.

block.Tracker = megaTracker;

Tracker dapat diubah kapan saja saat runtime. Proses load/unload akan terjadi saat session berjalan. Jika Anda mengatur Tracker menjadi null, target tersebut akan di-unload dari tracker yang sebelumnya diset. Pemuatan block adalah proses virtual dan tidak akan gagal.

Catatan

Ada beberapa syarat penting agar target dapat dilacak:

id dari MegaBlockController.Source harus dikonfigurasi dengan benar sebelum MonoBehaviour.Start().
block yang sesuai dengan id dari Source harus ada di library lokalisasi.
MegaBlockController.Tracker harus dikonfigurasi menggunakan library lokalisasi yang benar.

Biasanya tidak perlu konfigurasi tambahan, tetapi jika Anda memerlukan kontrol pelacakan multi-target, Anda dapat melakukan pengaturan yang sesuai.

Dalam sebagian besar skenario penggunaan Mega, tidak ada kebutuhan untuk memakai multi-target. Sebelum benar-benar paham cara mencegah beberapa block saling memengaruhi, disarankan hanya menempatkan satu block dalam satu library lokalisasi.

Kiat

Secara prinsip, Mega menghitung posisi perangkat di semua block, bukan memilih block yang terlihat perangkat dari library lokalisasi. Penggunaan yang kurang tepat dapat menurunkan hasil karena kebingungan data dan alasan lain.

Pilih objek Mega Tracker di bawah session, lalu ubah opsi Multi Block untuk mengaktifkan atau menonaktifkan fitur pelacakan multi-target.

Di script, Anda dapat mengubah BlockHolder.MultiBlock untuk mendapatkan efek yang sama.

Peringatan

Secara umum, satu library lokalisasi hanya dapat memiliki satu block pada satu waktu.

Mengubah konfigurasi multi-target akan memengaruhi hasil tracking, jadi umumnya tidak disarankan. Gunakan di bawah arahan dukungan teknis EasyAR.

Jika konfigurasi ini pernah diubah selama aplikasi berjalan, pastikan Anda menyebutkannya saat melaporkan masalah ke EasyAR.

Siklus hidup target pelacakan

Versi >= 4003
Versi 4.7 - 4002

Lifecycle umum sebuah target pelacakan adalah sebagai berikut:

flowchart LR
  sstart((session dimulai))
  sstop([session berhenti])
  
  start("Target.Start")
  load("Muat")
  tracking[["Tracking berkelanjutan"]]

  sstart --> load --> tracking --> sstop
  start -. "Target.Tracker = tracker" .-> load

Prosesnya secara garis besar dapat dibagi menjadi beberapa tahap:

Load: target pelacakan dimuat oleh tracker yang dikonfigurasi. Ini terjadi setelah Start() pada target itu sendiri dan session dimulai.
Proses tracking: setelah target pelacakan berhasil dilokalisasi, tracker akan terus melacak posisi dan status target sampai target lain berhasil dilokalisasi.
Unload: target pelacakan di-unload dari tracker, dan tracker tidak lagi melacak target. Ini terjadi ketika session berhenti atau target diatur agar tidak menggunakan tracker.

Table of Contents

Menambahkan target pelacakan Mega

Sebelum mulai

Catatan

Target pelacakan Mega

Catatan

Membuat target pelacakan

Penting

Kiat

Kiat

Catatan

Kiat

Mengonfigurasi target pelacakan

Mengonfigurasi sumber data target

Kiat

Mengonfigurasi tracker yang digunakan target

Catatan

Kiat

Peringatan

Siklus hidup target pelacakan

Langkah berikutnya

Topik terkait