Table of Contents

Menambahkan Target Pelacakan Mega Go

Dokumen ini menjelaskan cara menambahkan dan mengonfigurasi target pelacakan Mega Go.

Sebelum Memulai

Catatan

Konten dan alat berikut hanya berlaku untuk pengembangan aplikasi Unity menggunakan EasyAR Mega Go. Dibutuhkan versi plugin >= 4003.1.

Mega Go tidak mendukung pengembangan aplikasi kecil.

Konten dokumen ini membutuhkan paket Unity berikut yang sudah diimpor ke proyek:

  • com.easyar.sense

Target Pelacakan Mega Go

Target pelacakan Mega Go adalah objek kosong yang berisi komponen MegaGoBlockController, yang mewakili sebuah blok di Unity.

alt text

Catatan

Fitur editor blok tidak dapat digunakan saat paket com.easyar.mega belum diimpor, namun tidak mempengaruhi efek dan fungsi pelacakan saat runtime.

Membuat Target Pelacakan

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

alt text

Dalam skrip, Anda dapat menggunakan ARSessionFactory.CreateController untuk membuatnya.

ARSessionFactory.CreateController<MegaGoBlockController>();

Mengkonfigurasi Target Pelacakan

Sebelum menggunakan target, Anda perlu mengkonfigurasi sumber data dan pelacaknya.

Mengkonfigurasi Sumber Data Target

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

Anda dapat memilih node blok di tampilan Hierarchy, kemudian isi Path Type dan Path blok.

Dalam skrip, Anda dapat mengubah Source sebelum MonoBehaviour.Start() untuk mengatur sumber blok.

block.Source = new MegaGoBlockController.FileSourceData(PathType.Absolute, path);

Dimana

  • PathType adalah jenis jalur file emg, dapat berupa jalur absolut (Absolute) atau jalur StreamingAssets proyek (StreamingAssets).
  • Path adalah jalur file emg. Jika PathType adalah Absolute, ini adalah jalur absolut di sistem file. Jika PathType adalah StreamingAssets, ini adalah jalur relatif di folder StreamingAssets proyek.
Kiat

File emg harus diunduh dari halaman Mega Go di Pusat Pengembangan EasyAR.

Kiat

Karena file emg mungkin cukup besar, jika ukuran paket aplikasi terlalu besar, disarankan menggunakan jalur StreamingAssets hanya pada tahap pengujian. Saat menerbitkan aplikasi resmi, gunakan jalur absolut dan letakkan file emg di jalur sistem file yang dapat diakses aplikasi melalui paket sumber atau cara lainnya.

Mengkonfigurasi Pelacak yang Digunakan oleh Target

Target pelacakan akan dimuat dan dilacak oleh pelacak yang dikonfigurasi.

Penting

Pelacak Mega Go hanya dapat melacak satu blok pada satu waktu. Jika beberapa blok dikonfigurasi ke pelacak yang sama, hanya blok yang terakhir dimuat yang akan digunakan.

Anda dapat memilih node blok di tampilan Hierarchy, kemudian pilih Mega Go Tracker dalam sesi.

Dalam skrip, Anda dapat mengubah Tracker untuk mengatur pelacak blok.

block.Tracker = megaGoTracker;

Tracker dapat diubah kapan saja saat runtime. Pemuatan/pengunduhan akan terjadi saat sesi berjalan. Jika Tracker diatur ke null, target akan diunduh dari pelacak yang sebelumnya telah diatur.

Catatan

Ada beberapa syarat penting agar target dapat dilacak:

  1. Blok yang sesuai dengan Source harus berada dalam keadaan tersedia (data resmi selalu tersedia secara offline, data uji hanya tersedia jika data tersebut ada di layanan).
  2. File MegaGoBlockController.Source harus dimuat dengan benar.
  3. Setelah file dimuat, tidak ada file lain yang sesuai dengan blok lain yang dimuat.

Siklus Hidup Target Pelacakan

Berikut adalah siklus hidup target pelacakan yang umum:

flowchart LR
  sstart((session 启动))
  sstop([session 停止])
  
  start("Target.Start")
  load("加载")
  tracking[["持续跟踪"]]

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

Alur tersebut dapat dibagi menjadi beberapa tahap:

  • Pemuatan: Target pelacakan dimuat oleh pelacak yang dikonfigurasi. Ini akan terjadi setelah Start() target sendiri dan sesi dimulai.
  • Proses pelacakan: Setelah target pelacakan ditemukan, pelacak akan terus melacak posisi dan status target hingga target diunduh atau target lain dimuat.
  • Pengunduhan: Target pelacakan diunduh dari pelacak, dan pelacak tidak lagi melacak target. Ini akan terjadi saat sesi berhenti atau target diatur untuk tidak menggunakan pelacak.

Langkah Selanjutnya

Topik Terkait