Table of Contents

Diagnosis dan perbaikan: konten tidak ditampilkan

Artikel ini membahas masalah umum ketika konten virtual tidak dapat ditampilkan dalam planar image tracking. Artikel ini menyediakan metode troubleshooting sistematis dan saran perbaikan untuk membantu pengembang cepat menemukan dan menyelesaikan masalah.

Penyebab umum dan metode troubleshooting

Konten yang tidak ditampilkan biasanya berkaitan dengan image recognition, kesalahan implementasi fitur, atau pembatasan permission. Berikut penyebab utama dan langkah troubleshooting:

Kegagalan image recognition

Gejala: setelah kamera diarahkan ke target image, konten virtual sama sekali tidak muncul. Troubleshooting:

  • Periksa recognition score image: gunakan target image detection tool untuk mengunggah image dan memastikan recognition score, yang perlu mencapai 4-5 bintang.
  • Verifikasi kualitas image: pastikan image memenuhi persyaratan texture, ukuran, dan rasio dalam best practices.
  • Periksa entitas target image: pastikan permukaan entitas target image, seperti poster atau kartu, tidak reflektif, tetap rata, dan tidak terlipat.
  • Lihat logs: periksa application logs, cari event TargetLoad, dan pastikan target image berhasil dimuat.

Saran perbaikan:

  • Optimalkan image: tingkatkan kontras, hindari pola berulang, dan pastikan subjek utama memenuhi lebih dari 70% gambar.
  • Ganti image: jika masalah tetap ada setelah optimasi, gunakan test image dari Sample resmi, seperti namecard.jpg, untuk memverifikasi apakah masalah berasal dari image itu sendiri.
  • Pastikan entitas fisik: target entity sebaiknya menggunakan permukaan matte atau relatif kasar, dan permukaan tetap rata tanpa lipatan atau bengkok.
  • Periksa logika: pastikan aplikasi telah memuat target image yang digunakan untuk pengujian dengan benar.

Kesalahan implementasi fitur

Gejala: image telah dikenali, tetapi konten virtual tidak ditampilkan atau posisinya abnormal.

Troubleshooting:

  • Periksa konfigurasi ImageTarget:
    • Periksa apakah sesuai tipe Source sudah mengarah ke file yang benar di folder StreamingAssets.
    • Periksa apakah Scale telah diatur ke ukuran fisik aktual.
  • Konfirmasi hierarchy prefab: konten virtual, seperti Cube, harus merupakan child node dari ImageTarget dan tidak boleh dinonaktifkan.

Saran perbaikan:

  • Reset konfigurasi: hapus dan buat ulang ImageTarget di scene, drag prefab sesuai spesifikasi, dan bind image.
  • Sederhanakan pengujian: untuk sementara hapus custom scripts dan sisakan Cube dasar saja untuk memastikan scene minimum dapat berjalan.
  • Periksa logs: cari error terkait ImageTargetController, seperti fail to load target data.

Masalah permission

Gejala: awalnya berjalan normal, tetapi setelah berjalan beberapa waktu konten menghilang. Troubleshooting: Pastikan apakah Anda termasuk salah satu kondisi berikut:

  • Menggunakan XR headset
  • Menggunakan custom camera
  • Menggunakan AR Engine/ARFoundation di ponsel

Jika termasuk salah satu kondisi di atas, Anda mungkin sedang menggunakan License versi trial.

Saran perbaikan:

  • Gunakan License versi resmi.

Masalah konten virtual

Gejala: konten awalnya tampil normal, tetapi saat kamera sangat dekat/jauh dari target object, konten tidak terlihat. Troubleshooting:

  • Periksa pengaturan near dan far clipping: pastikan pengaturan near dan far clipping saat rendering konten virtual berada dalam rentang yang wajar.
  • Periksa ukuran content model: ketika content model terlalu besar, mendekati target object dapat menyebabkan clipping through sehingga konten tidak terlihat; ketika content model terlalu kecil, menjauh dari target object dapat membuat tampilan terlalu kecil untuk dilihat jelas.

Saran perbaikan:

  • Atur near dan far clipping yang sesuai.
  • Ukuran fisik konten virtual dibandingkan entitas target image harus sesuai.

Ringkasan dan praktik terbaik

Masalah konten tidak ditampilkan biasanya disebabkan oleh image, implementasi program, permission, atau konten itu sendiri. Disarankan troubleshooting secara berurutan:

  1. Periksa apakah License adalah versi resmi;
  2. Periksa apakah konten virtual itu sendiri sudah tepat;
  3. Verifikasi kualitas target image;
  4. Konfirmasi apakah ada masalah dalam implementasi program atau konfigurasi pengembangan.

Jika masalah berlanjut, berikan log files, rekaman layar, dan materi lain melalui forum resmi EasyAR atau dukungan teknis untuk analisis lebih lanjut.