Table of Contents

Diagnosa dan perbaikan: Gagal memuat target

Fungsi pelacakan objek 3D sangat bergantung pada kualitas model 3D yang dimasukkan. Ketika model target gagal dimuat, EasyAR akan mencetak log error detail untuk membantu pengembang mengidentifikasi masalah. Bab ini mencantumkan penyebab kegagalan umum dan solusinya, mencakup tiga jenis masalah: material, tekstur, dan file model.

Kesalahan file material/texture map

Kesalahan ini biasanya disebabkan oleh konfigurasi path atau masalah format file.

Informasi log Penyebab kesalahan Solusi
Material file not exist File material (.mtl) tidak ada atau tidak direferensikan dengan benar Periksa apakah file .mtl ada di folder model, dan path mtllib di file .obj mengarah dengan benar (path relatif)
Current material has no name Definisi material tidak memiliki nama (newmtl tidak ditentukan) Tambahkan nama untuk setiap material di file .mtl, misalnya newmtl Material1
No texture map exists in material Texture map tidak ditentukan dalam material (tidak ada map_Ka atau map_Kd) Tambahkan path tekstur di file .mtl, misalnya map_Kd texture.jpg
Read texture map file failed File texture map tidak dapat dibaca (path salah, format tidak didukung) Periksa apakah file tekstur ada di dalam folder model, formatnya JPG/PNG, dan path tidak mengandung spasi

Kesalahan file model

Kesalahan ini biasanya disebabkan oleh format file OBJ yang tidak standar atau masalah encoding.

Informasi log Penyebab kesalahan Solusi
Error in opening OBJ file Path file model tidak ada atau izin tidak cukup Periksa path file, pastikan file dapat dibaca
Error in reading OBJ file Gagal membaca file (encoding bukan UTF-8, file rusak) Buka file .obj dengan editor teks, simpan ulang dengan format encoding UTF-8
Material not exist Material yang direferensikan oleh permukaan (face) tidak ditemukan di file .mtl Periksa field usemtl di file .obj, pastikan konsisten dengan nama newmtl di .mtl
Vertex format invalid Format koordinat verteks salah (data baris v tidak sesuai standar) Periksa format v: v x y z (misal v -4.322898 6.063079 -40.241329), pastikan berupa angka
Vertex texture coordinate format invalid Format koordinat tekstur verteks salah (data baris vt tidak sesuai standar) Periksa format vt: vt u v (misal vt 0.929688 0.094622), pastikan angka antara 0-1
Face format invalid Jumlah verteks permukaan (face) kurang dari 3 (data baris f tidak valid) Periksa baris f, pastikan setiap permukaan memiliki minimal 3 verteks
Both vertex index and vertex texture coordinate index are required Format permukaan salah (tidak ada indeks verteks atau indeks tekstur) Periksa format baris f, pastikan berisi indeks verteks dan tekstur (misal f 1/1 2/2 3/3)
Vertex index format invalid Indeks verteks permukaan salah (indeks di luar jangkauan atau bukan bilangan bulat) Periksa indeks verteks di baris f, pastikan bilangan bulat positif dan tidak melebihi total verteks
Vertex texture coordinate index format invalid Indeks koordinat tekstur verteks pada permukaan salah Periksa indeks tekstur di baris f, pastikan bilangan bulat positif dan tidak melebihi total koordinat tekstur

Praktik terbaik

Saat mengalami kesalahan pemuatan, lakukan pemeriksaan berdasarkan informasi dalam tabel di atas. Secara umum, Anda harus mengikuti pedoman dasar berikut:

  • Jika model Anda diekspor dari alat profesional (seperti Blender, Maya), pastikan untuk mencentang "Tulis material" (Write materials) dan "Sertakan UV" (Include UVs) (atau opsi serupa) saat mengekspor, dan pastikan semua file berada dalam folder yang sama.
  • Path referensi internal dalam file model yang diekspor dari alat mungkin berupa path absolut, pastikan untuk memeriksa dan mengubahnya menjadi path relatif. Nama file hindari penggunaan spasi. Encoding file harus UTF-8.
  • Untuk persyaratan detail tentang format dan spesifikasi model, lihat bagian Persiapan model.

Tip: Jika masalah masih belum teratasi, disarankan untuk mengemas file model dan log error, lalu minta bantuan melalui forum resmi EasyAR atau dukungan teknis.