Diagnosis dan perbaikan: konten tidak ditampilkan

Artikel ini membahas masalah umum ketika konten virtual tidak dapat ditampilkan dalam 3D object 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 kegagalan object recognition, kesalahan implementasi fitur, atau pembatasan permission. Berikut penyebab utama dan langkah troubleshooting:

Kegagalan object recognition

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

• Periksa kualitas model: pastikan 3D model dan object memenuhi persyaratan file format, texture, geometry, dan lainnya dalam model preparation.
• Periksa target object: pastikan permukaan target object tidak memiliki material reflektif atau seperti cermin.
• Lihat logs: periksa application logs dan pastikan target model berhasil dimuat.

Saran perbaikan:

• Optimalkan model: pastikan texture cukup kaya dan geometry tidak memiliki lubang.
• Periksa logika: pastikan aplikasi telah memuat target model dengan benar. Jika loading gagal, lihat target loading failure untuk pemeriksaan dan perbaikan.

Kesalahan implementasi fitur

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

• Unity
• Native

Troubleshooting:

• Periksa konfigurasi ObjectTarget:
  • Periksa apakah sesuai tipe Source sudah mengarah ke file yang benar di folder StreamingAssets.
  • Periksa apakah Scale telah diubah sesuai ukuran aktual object. Misalnya jika ukuran BoundingBox yang dihitung dari file model adalah 10 x 10 x 30, sementara ukuran aktual object adalah 0.1m x 0.1m x 0.3m, maka Scale harus diatur ke 0.01.
• Konfirmasi hierarchy prefab:
  • Konten virtual harus berada pada level yang sama dengan target 3D model, dan keduanya harus merupakan child node dari ObjectTarget. Konten virtual tidak boleh dinonaktifkan.
  • Properti Rotation pada target 3D model perlu mengatur arah Y menjadi 180.
  • Penempatan konten virtual harus sepenuhnya mengelilingi posisi target 3D model.

Saran perbaikan:

• Reset konfigurasi: hapus dan buat ulang ObjectTarget di scene, drag prefab sesuai spesifikasi, dan bind 3D model.
• Periksa logs: cari error terkait ObjectTargetController, 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 target object harus sesuai.

Ringkasan dan praktik terbaik

Masalah konten tidak ditampilkan biasanya disebabkan oleh object 3D model, 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. Konfirmasi kualitas target 3D model;
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.