Menambahkan Target Pemantauan Mega

Artikel ini menjelaskan cara menambahkan dan mengkonfigurasi target pemantauan Mega.

Sebelum Memulai

Periksa Apakah pustaka lokalisasi saya sudah dapat digunakan?
Impor plugin EasyAR versi terbaru dan aktifkan fitur Mega
Pelajari konsep dasar dan cara penggunaan Target pelacakan AR Unity

Catatan

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

Jika Anda sedang mengembangkan mini-program, harap lihat Buat dan unggah anotasi menggunakan Unity Editor (Pengembangan mini-program).

Jika Anda tidak sedang mengembangkan aplikasi Unity, tetapi ingin melihat hasil pemetaan Mega, harap lihat Pratinjau jaringan pemandangan nyata 3D dalam Panduan Penggunaan Mega.

Jika Anda tidak sedang mengembangkan aplikasi Unity, tetapi perlu menjalankan simulasi untuk melihat efek lokalisasi, harap lihat Pratinjau efek simulasi dalam Panduan Penggunaan Mega.

Konten artikel ini memerlukan paket Unity berikut telah diimpor ke proyek:

Versi >= 4003
Versi 4.7 - 4002

com.easyar.sense

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

alt text

Catatan

Saat paket com.easyar.mega belum diimpor, fitur editor block tidak dapat digunakan, tetapi ini tidak mempengaruhi efek dan fitur pelacakan saat runtime.

Jika fitur Mega tidak diaktifkan dengan benar dalam konfigurasi, maka tidak akan dapat digunakan.

alt text

Membuat Target Pelacakan

Versi >= 4003
Versi 4.7 - 4002

Klik kanan di area kosong di tampilan Hierarchy, lalu melalui menu EasyAR Sense > Mega > Target : Mega Block Anda dapat membuat target pelacakan Mega.

alt text

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

ARSessionFactory.CreateController<MegaBlockController>();

Menambahkan target pelacakan di editor

Menggunakan metode ini memerlukan pengaturan BlockHolder.BlockRootSource menjadi External (default) atau Mixed.

Pertama, Anda perlu menambahkan alat Block Viewer for Unity Developer.

Klik kanan di area kosong di tampilan Hierarchy, lalu melalui menu EasyAR Mega > Tool > Block Viewer for Unity Developer (Edit Mode) Anda dapat menambahkan alat Block Viewer untuk pengembangan Unity.

Penting

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

Meskipun Annotation Tool juga memiliki fungsi serupa, sebagian fungsi alat ini akan dihapus di versi mendatang, jadi tidak disarankan untuk digunakan.

Fitur anotasi Annotation Tool (hanya anotasi itu sendiri) akan segera dipindahkan ke halaman web pusat pengembangan EasyAR, pemuatan block mesh dan penempatan model tidak terpengaruh.

Setelah alat berhasil ditambahkan, akan ada node EasyAR.Mega.BlockViewer (Dev) dan node MegaBlocks baru di hierarki adegan.

Kemudian gunakan alat untuk menghasilkan target pelacakan.

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

Klik tombol di sebelah kanan Mega Cloud Service;

Pilih Layanan Pemetaan Mega yang ingin digunakan, lalu klik OK.

Setelah memilih layanan, daftar block di pustaka saat ini akan ditampilkan di bawah node MegaBlocks dan di panel alat.

Kiat

Mengapa di bawah MegaBlocks kosong?

Disarankan untuk memeriksa Apakah pustaka pemetaan saya sudah bisa digunakan?

Sampai di sini, target pelacakan block telah dihasilkan. Setiap sub-node yang dimulai dengan Block_ di bawah node MegaBlocks mewakili satu target pelacakan block.
Menambahkan target pelacakan secara otomatis saat pemetaan berhasil

Menggunakan metode ini memerlukan pengaturan BlockHolder.BlockRootSource menjadi Internal atau Mixed.

Dalam kedua mode ini, jika suatu block baru ditemukan dan tidak ada block tersebut di bawah node BlockHolder.BlockRoot, block baru ini akan secara otomatis ditambahkan di bawah node BlockHolder.BlockRoot. Jika BlockHolder.BlockRoot tidak ada, akan dibuat secara otomatis.

Kiat

Saat menambahkan target pelacakan secara otomatis saat pemetaan berhasil, model block tidak dapat dimuat, hanya target pelacakan block yang dapat ditambahkan.
Menambahkan target pelacakan dalam skrip

Menggunakan metode ini memerlukan pengaturan BlockHolder.BlockRootSource menjadi Internal atau Mixed. Jika BlockHolder.BlockRoot tidak ada, akan dibuat secara otomatis. Atau Anda juga dapat menentukan objek BlockHolder.BlockRoot di editor sebelumnya saat BlockHolder.BlockRootSource adalah External.

Catatan

Jika block tidak ada di pustaka pemetaan, bahkan jika ditambahkan ke adegan menggunakan skrip, block tidak akan dapat ditemukan.

Anda dapat menggunakan metode BlockHolder.Hold untuk menambahkan block baru di bawah node BlockHolder.BlockRoot. Metode ini biasanya digunakan saat menggunakan file anotasi ema, skrip membaca informasi anotasi kemudian menambahkan block.

Misalnya, potongan kode berikut menunjukkan cara menambahkan block menggunakan informasi dari 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 menggunakan skrip saat runtime, model block tidak dapat dimuat, hanya target pelacakan block yang dapat ditambahkan.

Mengkonfigurasi target pelacakan

Mengkonfigurasi Sumber Data Target

Versi >= 4003
Versi 4.7 - 4002

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

Di tampilan Hierarchy, Anda dapat memilih node block kemudian mengisi ID dan Nama block.

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

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

Dimana

block id adalah identifikasi unik block, harus diisi.
block name adalah nama block, dapat diisi sesuai kebutuhan, umumnya disarankan untuk mengisi nama asli block agar mudah diidentifikasi.

Kiat

block id dan name dapat diambil dari pustaka lokalisasi yang sesuai di Pusat Pengembangan EasyAR.

Jika tidak ada data block di pustaka lokalisasi, Anda perlu Menambahkan Block yang Dibutuhkan ke dalam Pusat Lokalisasi, dan periksa kembali Pustaka Lokalisasi Cloud Berlaku.

Di MegaTrackerFrameFilter, tentukan target yang akan digunakan yaitu block.

Dalam kebanyakan kasus, disarankan untuk mempertahankan konfigurasi default, yaitu menggunakan Mega Studio untuk mengimpor block di editor.

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

Sementara itu, Anda perlu menentukan Block Root sebagai objek MegaBlocks di dalam adegan.

Mengubah opsi Block Root Source dapat menentukan cara sumber block lainnya, misalnya saat mengimpor data menggunakan ema, biasanya Anda akan memilih opsi Internal atau Mixed.

Dalam skrip, Anda dapat mengubah BlockHolder.BlockRootSource untuk mencapai hasil yang sama.

Mengkonfigurasi Pelacak yang Digunakan oleh Target

Versi >= 4003
Versi 4.7 - 4002

Target pelacakan akan dimuat oleh pelacak yang dikonfigurasi dan dilacak setelah ditemukan posisinya dengan benar.

Di tampilan Hierarchy, Anda dapat memilih node block dan kemudian memilih Mega Tracker dalam sesi.

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

block.Tracker = megaTracker;

Tracker dapat diubah kapan saja saat runtime. Pemuatan/pengunduhan akan terjadi saat sesi berjalan. Jika Anda mengatur Tracker menjadi null, target tersebut akan diunduh dari pelacak yang sebelumnya diatur. Pemuatan block adalah proses virtual dan tidak akan gagal.

Catatan

Ada beberapa syarat kunci untuk pelacakan target:

Id MegaBlockController.Source harus dikonfigurasi dengan benar sebelum MonoBehaviour.Start().
Block yang sesuai dengan id Source tersebut harus ada dalam pustaka lokalisasi.
MegaBlockController.Tracker harus dikonfigurasi untuk menggunakan pustaka lokalisasi yang benar.

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

Dalam sebagian besar skenario penggunaan Mega, tidak ada kebutuhan untuk menggunakan multi-target. Sebelum Anda menguasai cara menghindari interaksi saling mengganggu antara beberapa block, disarankan untuk hanya menempatkan satu block dalam satu pustaka lokalisasi.

Kiat

Secara prinsip, Mega akan menghitung posisi perangkat di semua block, bukan memilih block yang terlihat oleh perangkat dari pustaka lokalisasi. Penggunaan yang tidak terencana mungkin menyebabkan penurunan kualitas akibat kebingungan data dan faktor lainnya.

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

Dalam skrip, Anda dapat mengubah BlockHolder.MultiBlock untuk mencapai efek yang sama.

Peringatan

Pada umumnya, hanya ada satu block yang dapat ada secara bersamaan dalam satu pustaka lokalisasi.

Mengubah konfigurasi multi-target akan mempengaruhi hasil pelacakan. Umumnya tidak disarankan untuk mengubahnya. Harap gunakan dengan panduan dukungan teknis EasyAR.

Jika konfigurasi ini diubah selama eksekusi aplikasi, pastikan Anda menyebutkan hal ini saat melaporkan masalah ke EasyAR.

Siklus hidup target pelacakan

Versi >= 4003
Versi 4.7 - 4002

Siklus hidup target pelacakan yang umum adalah sebagai berikut:

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

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

Proses secara umum dibagi menjadi beberapa tahap:

Pemuatan: target pelacakan dimuat oleh pelacak yang dikonfigurasi, ini terjadi setelah Start() target itu sendiri dan session dimulai.
Proses pelacakan: setelah target pelacakan ditemukan lokasinya, pelacak akan terus melacak posisi dan status target sampai target lain ditemukan lokasinya.
Pembongkaran: target pelacakan dibongkar dari pelacak, dan pelacak tidak lagi melacak target. Ini terjadi setelah session dihentikan atau target diatur untuk tidak menggunakan pelacak.

Table of Contents

Menambahkan Target Pemantauan Mega

Sebelum Memulai

Catatan

Mega 的跟踪目标

Catatan

Membuat Target Pelacakan

Penting

Kiat

Kiat

Catatan

Kiat

Mengkonfigurasi target pelacakan

Mengkonfigurasi Sumber Data Target

Kiat

Mengkonfigurasi Pelacak yang Digunakan oleh Target

Catatan

Kiat

Peringatan

Siklus hidup target pelacakan

Langkah selanjutnya

Topik terkait