Table of Contents

Pemecahan masalah: konten tidak ditampilkan/diaktifkan

Saat menggunakan image cloud recognition, Anda mungkin mengalami masalah ketika konten virtual tidak dapat ditampilkan atau diaktifkan. Artikel ini menyediakan metode pemecahan masalah yang sistematis. Perlu diperhatikan bahwa dalam sebagian besar kasus, penyebab kegagalan image cloud recognition sama persis dengan kegagalan pengenalan lokal. Anda dapat merujuk ke bagian Pemecahan masalah pada planar image tracking. Bagian ini hanya menambahkan masalah dan solusi khusus untuk cloud recognition.

Penyebab umum dan metode pemecahan masalah

Masalah koneksi jaringan

Fenomena: Tidak ada respons setelah permintaan recognition dikirim, atau kode kesalahan dikembalikan.
Metode pemecahan masalah:

  • Periksa apakah perangkat terhubung ke jaringan (Wi-Fi/4G/5G), dan coba buka halaman web untuk memverifikasinya.
  • Periksa apakah aplikasi telah mengaktifkan izin jaringan.
  • Tangkap log kesalahan jaringan dalam kode.
  • Uji konektivitas CRS API di browser (referensi: Health check | GET /ping).

Saran perbaikan:

  • Tambahkan deteksi status jaringan di dalam aplikasi dan tampilkan prompt saat jaringan lemah.
  • Atur timeout permintaan, lalu retry atau downgrade ke local tracking.

Kesalahan konfigurasi layanan

Fenomena: Permintaan recognition ditolak dan mengembalikan Unauthorized atau Invalid Key.
Metode pemecahan masalah:

  • Periksa apakah CRS API Key dan Secret yang diisi dalam kode sudah benar.
  • Periksa bahwa Client-end URL yang diisi dalam kode tidak salah (misalnya keliru diisi sebagai Server-end URL).
  • Pastikan License Key telah diaktifkan dan belum kedaluwarsa (periksa di account center pada situs resmi EasyAR).

Saran perbaikan:

  • Gunakan tombol Copy di CRS image library untuk menyalin konfigurasi layanan terkait Anda dan memastikan isinya benar.

Kesalahan konfigurasi target library/aplikasi

Fenomena: Target image tertentu sebelumnya dapat dikenali tanpa masalah, tetapi sekarang permintaan recognition gagal.
Metode pemecahan masalah:

  • Dapatkan status target melalui CRS API dan pastikan target image berada dalam status "activated" ("active":"1").
  • Periksa apakah target ID benar-benar sama dengan yang ada di kode (peka huruf besar/kecil).

Saran perbaikan:

  • Saat cloud image library diperbarui/diubah, pastikan target tertentu yang digunakan aplikasi selalu aktif.
  • Lakukan pemeriksaan kode dengan cermat.

Kegagalan pemuatan lokal dalam mode hybrid

Fenomena: Cloud recognition berhasil, tetapi local tracking tidak dimulai dan konten tidak ditampilkan.
Metode pemecahan masalah:

  • Pastikan tidak ada exception saat ImageTarget lokal dimuat (periksa log).
  • Verifikasi apakah ImageTracker telah diaktifkan.

Saran perbaikan:

  • Bungkus logika pemuatan lokal dengan try-catch, tangkap exception, lalu retry.
  • Pastikan konten virtual adalah child object dari ImageTarget dan tidak dinonaktifkan.

Ringkasan dan praktik terbaik

Masalah konten cloud recognition yang tidak ditampilkan terutama berfokus pada tiga aspek: jaringan, konfigurasi layanan, dan status target. Dalam mode hybrid, pemuatan lokal juga perlu diperhatikan. Disarankan melakukan pemecahan masalah dalam urutan berikut:

  1. Periksa koneksi jaringan dan pastikan konektivitas layanan CRS;
  2. Periksa pengaturan layanan seperti License, API Key/Secret, dan Client-end URL.
  3. Periksa status target image di CRS image library dan pastikan image library konsisten dengan target ID dalam aplikasi;

Jika masalahnya kompleks, aktifkan log debug EasyAR atau hubungi dukungan teknis.