Table of Contents

Diagnosa dan perbaikan: konten tidak ditampilkan

Artikel ini memberikan metode pemeriksaan sistematis dan saran perbaikan untuk masalah umum konten virtual yang gagal ditampilkan dalam pelacakan gambar planar, membantu pengembang dengan cepat mengidentifikasi dan menyelesaikan masalah.

Penyebab umum dan metode pemeriksaan

Konten yang tidak ditampilkan biasanya melibatkan kegagalan pengenalan gambar, kesalahan implementasi fungsi, atau pembatasan izin. Berikut adalah penyebab utama dan langkah pemeriksaan:

Kegagalan pengenalan gambar

Gejala: Konten virtual sama sekali tidak muncul setelah kamera diarahkan ke gambar target.
Metode pemeriksaan:

  • Periksa tingkat pengenalan gambar: Gunakan alat deteksi gambar target untuk mengunggah gambar, pastikan skor pengenalan (harus mencapai 4-5 bintang).
  • Verifikasi kualitas gambar: Pastikan gambar memenuhi persyaratan tekstur, ukuran, dan rasio dalam praktik terbaik.
  • Periksa entitas gambar target: Pastikan permukaan entitas gambar target (seperti poster, kartu) tidak memantulkan cahaya, tetap rata tanpa lipatan.
  • Periksa log: Periksa log aplikasi, cari peristiwa TargetLoad, konfirmasi apakah gambar target berhasil dimuat.

Saran perbaikan:

  • Optimalkan gambar: Tingkatkan kontras, hindari pola berulang, pastikan subjek menempati >70% frame.
  • Ganti gambar: Jika masalah tetap ada setelah optimasi, gunakan gambar uji dari sampel resmi (contoh: namecard.jpg) untuk verifikasi.
  • Pastikan entitas fisik: Gunakan permukaan matte atau kasar, pertahankan permukaan rata tanpa lipatan/lekukan.
  • Periksa logika: Pastikan aplikasi telah memuat gambar target uji dengan benar.

Kesalahan implementasi fungsi

Gejala: Gambar dikenali, tetapi konten virtual tidak ditampilkan atau posisi abnormal.

Metode pemeriksaan:

  • Periksa konfigurasi ImageTarget:
    • Sesuai tipe Source, periksa apakah mengarah ke file yang benar di folder StreamingAssets.
    • Apakah Scale diatur ke ukuran fisik aktual.
  • Konfirmasi hierarki prefab: Konten virtual (contoh: Cube) harus menjadi simpul turunan dari ImageTarget, dan tidak dinonaktifkan.

Saran perbaikan:

  • Setel ulang konfigurasi: Hapus dan buat ulang ImageTarget di scene, seret prefab sesuai standar dan ikat gambar.
  • Sederhanakan pengujian: Sementara hapus skrip kustom, pertahankan hanya Cube dasar, verifikasi scene minimum yang dapat dijalankan.
  • Periksa log: Cari kesalahan terkait ImageTargetController, seperti fail to load target data.

Masalah izin

Gejala: Semula berfungsi normal, tetapi konten menghilang setelah beberapa waktu penggunaan.
Metode pemeriksaan:
Konfirmasi apakah Anda termasuk dalam salah satu situasi berikut:

  • Menggunakan headset XR
  • Menggunakan kamera kustom
  • Menggunakan AR Engine/ARFoundation di ponsel

Jika termasuk salah satu situasi di atas, kemungkinan Anda menggunakan Lisensi versi percobaan.

Saran perbaikan:

  • Gunakan Lisensi versi resmi.

Masalah konten virtual

Gejala: Konten semula ditampilkan normal, tetapi tidak terlihat saat kamera sangat dekat/jauh dari objek target.
Metode pemeriksaan:

  • Periksa pengaturan near-far clipping: Pastikan rentang near-far clipping saat rendering konten virtual berada dalam batas wajar.
  • Periksa ukuran model konten: Model konten terlalu besar dapat menyebabkan "tembus objek" saat mendekati target; model terlalu kecil dapat menyulitkan penglihatan saat menjauhi target.

Saran perbaikan:

  • Atur near-far clipping yang sesuai.
  • Pastikan ukuran fisik konten virtual proporsional terhadap entitas gambar target.

Ringkasan dan praktik terbaik

Masalah konten tidak ditampilkan biasanya disebabkan oleh gambar, implementasi program, izin, atau konten itu sendiri. Disarankan untuk memeriksa secara berurutan:

  1. Verifikasi apakah Lisensi versi resmi;
  2. Periksa apakah konten virtual itu sendiri sesuai;
  3. Validasi kualitas gambar target;
  4. Konfirmasi apakah ada masalah dalam implementasi program atau konfigurasi pengembangan.

Jika masalah berlanjut, berikan file log, rekaman layar, dll. untuk analisis lebih lanjut melalui forum resmi EasyAR atau dukungan teknis.