Alat verifikasi dan diagnostik di lokasi
Artikel ini menjelaskan pengaturan lokalisasi, antarmuka saat berjalan, dan cara melaporkan data abnormal di Mega Toolbox (Mini Program). Gunakan file mask untuk memeriksa keselarasan model dengan lingkungan nyata, atau muat data anotasi untuk melihat penempatan konten virtual.
Sebelum memulai
- Ikuti pengantar alat untuk menyiapkan basis data lokalisasi cloud, akun EasyAR, dan ponsel uji, lalu pergi ke lokasi Block target.
- Untuk menggunakan file mask, versi pemetaan Block harus 9.6 atau lebih baru. Periksa di halaman detail Block.
- Untuk menggunakan data anotasi, buat data anotasi untuk verifikasi di lokasi dan pastikan paketnya termasuk dalam basis data yang akan diuji. Lewati langkah ini jika tidak memakai anotasi.
Contoh langkah lengkap ada di Hasil Mini Program.
Cara memperoleh alat
Pindai kode Mini Program di bawah dengan WeChat untuk membuka Mega Toolbox (Mini Program).
Masuk ke akun
Gunakan akun EasyAR Developer Center yang dapat mengakses basis data lokalisasi cloud target. Nomor pada gambar menunjukkan nama pengguna, kata sandi, dan tombol masuk.
- Masukkan nama pengguna.
- Masukkan kata sandi.
- Klik
Masuk.
Pilih basis data lokalisasi dan data anotasi
Pilih basis data lokalisasi cloud target, pilih paket anotasi jika diperlukan, lalu klik Mulai. Pengaturan pada gambar dijelaskan di bawah.
| No. | Pengaturan | Keterangan |
|---|---|---|
| 1 | Basis data lokalisasi cloud | Pilih basis data yang berisi Block target. Daftar menampilkan "nama grup layanan | nama basis data". |
| 2 | Ubah alamat |
Biasanya jangan dicentang. Jika perlu alamat layanan lain, misalnya layanan luar negeri, sesuaikan dengan konfigurasi layanan. |
| 3 | Tes di luar lokasi |
Jangan dicentang saat menguji di lingkungan nyata; centang hanya untuk tes di luar lokasi dengan foto atau materi serupa. |
| 4 | Tes mulai dingin |
Digunakan untuk pengujian khusus mulai dingin. Jangan dicentang untuk verifikasi rutin di lokasi. |
| 5 | Paket data anotasi | Pilih paket yang akan dimuat. Untuk hanya memeriksa lokalisasi atau menampilkan file mask, pilih Jangan gunakan anotasi. |
| 6 | Tampilkan nama anotasi |
Saat memuat anotasi, centang bila perlu untuk menampilkan namanya. |
| 7 | Mulai |
Buka halaman lokalisasi dengan pengaturan saat ini. |
Saat pertama kali masuk ke halaman lokalisasi, berikan izin kamera dan lokasi sesuai permintaan WeChat.
Masuk ke antarmuka lokalisasi
Arahkan kamera ponsel ke area yang terang dan kaya tekstur visual, lalu gerakkan ponsel secara stabil hingga deteksi bidang WeChat selesai diinisialisasi. Biarkan Lokalisasi Mega aktif dan tunggu hasil cloud.
Lihat hasil lokalisasi dan kontrol
Aktifkan Informasi Debug untuk melihat perangkat, adegan, permintaan, dan hasil lokalisasi. Gambar menunjukkan antarmuka setelah lokalisasi berhasil dan anotasi dimuat; kubus anotasi tidak muncul jika anotasi tidak digunakan.
| No. | Kontrol atau informasi | Keterangan |
|---|---|---|
| 1 | Informasi Debug |
Tampilkan atau sembunyikan panel informasi debug. |
| 2 | Rekam log |
Mulai atau hentikan perekaman log. Setelah berhenti, pilih penerima di antarmuka berbagi WeChat untuk mengekspor file. |
| 3 | Rekam data |
Mulai atau hentikan perekaman data dump. Setelah berhenti, pilih penerima di antarmuka berbagi WeChat untuk mengekspor file. |
| 4 | Opsi lanjutan |
Tampilkan atau sembunyikan opsi lanjutan. |
| 5 | Lokalisasi Mega |
Mulai atau hentikan lokalisasi cloud Mega. |
| 6 | Hasil lokalisasi cloud | Lihat status, waktu respons permintaan, dan Block yang ditemukan. |
| 7 | Riwayat lokalisasi | Sequence menunjukkan status sebelumnya: N belum dimuat, S berhasil, F gagal. Tombol Status hijau saat berhasil dan putih saat gagal. |
Hasil yang umum dan cara menanganinya:
| Hasil | Arti dan tindakan |
|---|---|
Found |
Block target berhasil ditemukan. Bandingkan mesh mask atau anotasi dengan lingkungan nyata untuk memeriksa keselarasan. |
Not Found |
Permintaan ini tidak menemukan Block target. Pastikan Anda berada di lokasi, Block sudah masuk basis data, dan kamera mengarah ke area bertekstur. Jika terus gagal, lihat Panduan masalah lokalisasi. |
QpsLimitExceeded |
Permintaan melebihi kuota QPS grup layanan cloud. Lihat Perkiraan dan perluasan QPS untuk memeriksa penggunaan atau menambah kapasitas. |
UnKnownError |
Mungkin terkait jaringan, transfer data, atau respons layanan. Ikuti Panduan masalah lokalisasi, lalu rekam log dan data bila perlu. |
Tampilkan file mask
Setelah berhasil menemukan Block yang mendukung file mask, aktifkan File mask. Mini Program otomatis memuat dan menampilkan mesh mask tanpa perlu mengunduh file atau membuat anotasi.
| No. | Kontrol | Keterangan |
|---|---|---|
| 8 | File mask |
Tampilkan atau sembunyikan mesh mask. |
| 9 | Penggeser opasitas | Atur opasitas mesh mask dari 0% hingga 100% untuk membandingkannya dengan gambar kamera nyata. |
Permukaan tanah dan vertikal ditampilkan dalam warna berbeda, dan mesh dapat menutupi dirinya sendiri. Periksa keselarasan dinding, lantai, sambungan, dan sudut, serta getaran atau drift saat ponsel digerakkan. Contoh ada di File mask.
Jika mesh mask tidak muncul, pastikan Block target sudah ditemukan, versi pemetaannya memenuhi syarat, sakelar aktif, dan opasitas di atas 0%. Lalu tunggu sumber daya selesai dimuat.
Lihat hasil anotasi
Jika paket anotasi dipilih sebelum memulai, kontennya dapat dilihat dalam adegan nyata setelah lokalisasi. Kubus anotasi bertekstur MEGA putih saat berhasil dan abu-abu saat gagal.
Bandingkan anotasi dengan posisi nyata yang dipilih saat membuatnya. Bedakan kegagalan lokalisasi dari getaran atau drift setelah berhasil; untuk yang terakhir, lihat Masalah pelacakan.
Laporkan data lokalisasi abnormal
Jika lokalisasi gagal, bergeser, bergetar, atau drift, rekam log dan data dump bersamaan saat mereproduksi masalah. Penerima harus dipilih secara manual saat berbagi file.
Pada halaman lokalisasi, aktifkan
Rekam logdanRekam data. Pastikan perekaman dimulai, lalu reproduksi masalah.Setelah masalah muncul, matikan
Rekam datauntuk menghentikan perekaman.
Di antarmuka berbagi WeChat, pilih
File Transfer Assistantdan simpan file data.
Kembali ke halaman lokalisasi dan matikan
Rekam log. Simpan file log melalui WeChat. Selesaikan perekaman dan ekspor sebelum meninggalkan halaman.Kirim file data, file log, dan uraian masalah ke dukungan teknis EasyAR. Sertakan basis data dan Block, waktu uji, model ponsel, versi sistem dan WeChat, gejala, serta langkah reproduksi. Lampirkan tangkapan layar atau video bila ada.
Petunjuk perekaman dan ekspor data dump ada di Merekam file dump dengan Mega Toolbox (Mini Program).