Diagnosa dan perbaikan: Konten tidak ditampilkan

Artikel ini memberikan metode pemeriksaan sistematis dan saran perbaikan untuk masalah umum konten virtual yang tidak ditampilkan dalam pelacakan objek 3D, membantu pengembang dengan cepat menemukan dan menyelesaikan masalah.

Penyebab umum dan metode pemeriksaan

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

Kegagalan pengenalan objek

Gejala: Setelah kamera diarahkan ke objek target, konten virtual tidak muncul sama sekali.
Metode pemeriksaan:

• Periksa kualitas model: Pastikan model 3D dan objek memenuhi persyaratan format file, tekstur geometri, dll. dalam Persiapan Model.
• Periksa objek target: Pastikan permukaan objek target tidak memiliki bahan reflektif atau seperti cermin.
• Lihat log: Periksa log aplikasi, periksa apakah model target berhasil dimuat.

Saran perbaikan:

• Optimalkan model: Pastikan tekstur cukup kaya, struktur geometri tidak memiliki lubang.
• Periksa logika: Pastikan aplikasi telah memuat model target dengan benar. Jika mengalami kegagalan pemuatan, lihat bab Kegagalan Memuat Target untuk pemeriksaan dan perbaikan.

Kesalahan implementasi fungsi

Gejala: Objek telah dikenali, tetapi konten virtual tidak ditampilkan atau posisinya tidak normal.

• Unity
• Native

Metode pemeriksaan:

• Periksa konfigurasi ObjectTarget:
  • Periksa apakah Source mengarah ke file yang benar di folder StreamingAssets berdasarkan tipenya.
  • Apakah Scale telah dimodifikasi sesuai ukuran aktual objek (misalnya, jika nilai dimensi BoundingBox yang dihitung dari file model adalah 10 x 10 x 30, sedangkan ukuran aktual objek adalah 0,1m x 0,1m x 0,3m, maka Scale harus disetel ke 0,01).
• Konfirmasi hierarki prefab:
  • Konten virtual harus berada di level yang sama dengan model 3D target, dan keduanya merupakan node anak dari ObjectTarget. Konten virtual tidak boleh dinonaktifkan.
  • Properti Rotation model 3D target perlu mengatur arah Y ke 180.
  • Penempatan konten virtual harus sepenuhnya mengelilingi posisi model 3D target.

Saran perbaikan:

• Setel ulang konfigurasi: Hapus dan buat ulang ObjectTarget di scene, seret prefab sesuai norma dan ikat model 3D.
• Periksa log: Cari kesalahan terkait ObjectTargetController, seperti fail to load target data.

Masalah izin

Gejala: Awalnya berfungsi normal, tetapi konten menghilang setelah dijalankan beberapa saat.
Metode pemeriksaan:
Konfirmasi apakah Anda termasuk dalam salah satu situasi berikut:

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

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

Saran perbaikan:

• Gunakan Lisensi versi resmi.

Masalah konten virtual

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

• Periksa pengaturan pemotongan dekat/jauh: Pastikan pengaturan pemotongan dekat/jauh saat merender konten virtual berada dalam kisaran yang wajar.
• Periksa ukuran model konten: Ketika model konten terlalu besar, mendekati objek target dapat menyebabkan kliping sehingga konten tidak terlihat; ketika model konten terlalu kecil, menjauhi objek target dapat menyebabkan tampilan terlalu kecil sehingga tidak jelas.

Saran perbaikan:

• Atur pemotongan dekat/jauh yang sesuai.
• Ukuran fisik konten virtual sesuai dengan objek target.

Ringkasan dan praktik terbaik

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

1. Periksa apakah Lisensi adalah versi resmi;
2. Periksa apakah konten virtual itu sendiri tepat;
3. Konfirmasi kualitas model 3D target;
4. Konfirmasi apakah ada masalah implementasi program atau konfigurasi pengembangan.

Jika masalah berlanjut, analisis lebih lanjut dapat dilakukan melalui forum resmi EasyAR atau dukungan teknis dengan menyediakan file log, rekaman layar, dll.