Table of Contents

Pemecahan masalah: Konten tidak ditampilkan/diaktifkan

Saat menggunakan pengenalan awan gambar, Anda mungkin mengalami masalah di mana konten virtual tidak dapat ditampilkan atau diaktifkan. Artikel ini akan menyediakan metode pemeriksaan sistematis. Perlu diingat bahwa dalam banyak kasus, penyebab kegagalan pengenalan awan gambar sepenuhnya sama dengan kegagalan pengenalan lokal. Anda dapat merujuk ke bab Pemecahan masalah untuk pelacakan gambar datar. Di sini hanya menambahkan masalah dan solusi khusus untuk pengenalan awan.

Penyebab umum dan metode pemeriksaan

Masalah koneksi jaringan

Gejala: Permintaan pengenalan dikirim tanpa respons, atau mengembalikan kode kesalahan. Metode pemeriksaan:

  • Periksa apakah perangkat terhubung ke internet (Wi-Fi/4G/5G), coba buka halaman web untuk memverifikasi.
  • Periksa apakah aplikasi memiliki izin akses internet.
  • Tangkap log kesalahan jaringan dalam kode.
  • Uji konektivitas API CRS di browser (referensi: Pemeriksaan kesehatan | GET /ping).

Saran perbaikan:

  • Tambahkan deteksi status jaringan dalam aplikasi, berikan peringatan saat jaringan lemah.
  • Setel batas waktu permintaan dan coba ulang atau downgrade ke pelacakan lokal.

Kesalahan konfigurasi layanan

Gejala: Permintaan pengenalan ditolak, mengembalikan Unauthorized atau Invalid Key. Metode pemeriksaan:

  • Periksa apakah CRS API Key dan Secret yang dimasukkan dalam kode sudah benar.
  • Periksa apakah Client-end URL yang dimasukkan dalam kode tidak salah (misalnya, secara tidak sengaja mengisi Server-end URL).
  • Pastikan License Key telah diaktifkan dan belum kedaluwarsa (lihat di pusat akun situs web EasyAR).

Saran perbaikan:

  • Gunakan tombol salin di galeri CRS untuk menyalin konfigurasi layanan terkait Anda, pastikan pengisian benar.

Kesalahan konfigurasi pustaka target/aplikasi

Gejala: Gambar target tertentu sebelumnya dapat dikenali tanpa masalah, tetapi sekarang permintaan pengenalan gagal. Metode pemeriksaan:

  • Dapatkan status target melalui API CRS, pastikan gambar target dalam status "diaktifkan" ("active":"1").
  • Periksa apakah ID target sepenuhnya konsisten dengan yang ada dalam kode (peka huruf besar/kecil).

Saran perbaikan:

  • Saat galeri awan diperbarui/diubah, pastikan target tertentu di aplikasi selalu diaktifkan.
  • Pemeriksaan kode yang cermat.

Kegagalan pemuatan lokal dalam mode campuran

Gejala: Pengenalan awan berhasil, tetapi pelacakan lokal tidak dimulai, konten tidak ditampilkan. Metode pemeriksaan:

  • Konfirmasi bahwa pemuatan lokal ImageTarget tidak memunculkan pengecualian (periksa log).
  • Verifikasi apakah ImageTracker telah diaktifkan.

Saran perbaikan:

  • Gunakan try-catch untuk membungkus logika pemuatan lokal, tangkap pengecualian dan coba ulang.
  • Pastikan konten virtual adalah objek turunan dari ImageTarget dan tidak dinonaktifkan.

Kesimpulan dan praktik terbaik

Masalah konten pengenalan awan yang tidak ditampilkan terutama berfokus pada tiga aspek: jaringan, konfigurasi layanan, status target. Mode campuran juga perlu memperhatikan tautan pemuatan lokal. Disarankan untuk memeriksa secara prioritas dalam urutan berikut:

  1. Periksa koneksi jaringan, konfirmasi konektivitas layanan CRS;
  2. Periksa pengaturan layanan seperti Lisensi, API Key/Secret, Client-end URL.
  3. Periksa status gambar target di galeri CRS, pastikan ID target di galeri konsisten dengan di aplikasi;

Jika masalahnya kompleks, Anda dapat mengaktifkan log debug EasyAR atau menghubungi dukungan teknis.