Diagnosis dan Perbaikan: Target Gagal Dimuat
Fitur 3D object tracking sangat bergantung pada kualitas model 3D input. Saat pemuatan model target gagal, EasyAR akan mencetak log error detail untuk membantu developer menemukan masalah. Bab ini mencantumkan penyebab umum dan solusi, mencakup masalah material, texture, dan file model.
Error File Material/Texture Map
Error jenis ini biasanya disebabkan oleh konfigurasi path atau masalah format file.
| Log Message | Penyebab Error | Solusi |
|---|---|---|
| Material file not exist | Path file material (.mtl) tidak ada atau tidak direferensikan dengan benar | Periksa apakah file .mtl ada di folder model dan apakah path mtllib dalam file .obj menunjuk dengan benar menggunakan path relatif |
| Current material has no name | Definisi material tidak memiliki nama (newmtl belum ditentukan) |
Tambahkan nama untuk setiap material dalam file .mtl, misalnya newmtl Material1 |
| No texture map exists in material | Tidak ada texture map yang ditentukan dalam material (map_Ka atau map_Kd hilang) |
Tambahkan path texture dalam file .mtl, misalnya map_Kd texture.jpg |
| Read texture map file failed | File texture map tidak dapat dibaca (path salah atau format tidak didukung) | Periksa apakah file texture berada di folder model, berformat JPG/PNG, dan path tidak berisi spasi |
Error File Model
Error jenis ini biasanya disebabkan oleh format file OBJ yang tidak sesuai standar atau masalah encoding.
| Log Message | Penyebab Error | Solusi |
|---|---|---|
| Error in opening OBJ file | Path file model tidak ada atau izin tidak mencukupi | Periksa path file dan pastikan file dapat dibaca |
| Error in reading OBJ file | Pembacaan file gagal (encoding bukan UTF-8 atau file rusak) | Buka file .obj dengan editor teks lalu simpan sebagai encoding UTF-8 |
| Material not exist | Material yang direferensikan oleh face tidak ditemukan dalam file .mtl | Periksa field usemtl dalam file .obj dan pastikan sesuai dengan nama newmtl dalam file .mtl |
| Vertex format invalid | Format koordinat vertex salah (data baris v tidak sesuai spesifikasi) |
Periksa format v: v x y z (misalnya v -4.322898 6.063079 -40.241329), dan pastikan nilainya numerik |
| Vertex texture coordinate format invalid | Format koordinat texture vertex salah (data baris vt tidak sesuai spesifikasi) |
Periksa format vt: vt u v (misalnya vt 0.929688 0.094622), dan pastikan nilainya antara 0 dan 1 |
| Face format invalid | Jumlah vertex face kurang dari 3 (data baris f tidak valid) |
Periksa baris f dan pastikan setiap face berisi setidaknya 3 vertex |
| Both vertex index and vertex texture coordinate index are required | Format face salah (vertex index atau texture index hilang) | Periksa format baris f dan pastikan berisi vertex index dan texture index (misalnya f 1/1 2/2 3/3) |
| Vertex index format invalid | Vertex index pada face salah (index di luar rentang atau bukan integer) | Periksa vertex index pada baris f dan pastikan berupa integer positif serta tidak melebihi jumlah total vertex |
| Vertex texture coordinate index format invalid | Texture coordinate index pada face salah | Periksa texture index pada baris f dan pastikan berupa integer positif serta tidak melebihi jumlah total texture coordinate |
Praktik Terbaik
Saat terjadi error pemuatan, lakukan pemeriksaan berdasarkan informasi pada tabel di atas. Secara umum, ikuti pedoman dasar berikut:
- Jika model Anda diekspor dari tool profesional seperti Blender atau Maya, pastikan memilih "write materials" dan "include UVs" (atau opsi serupa) saat ekspor, dan pastikan semua file berada di folder yang sama.
- Path referensi dalam file model yang diekspor tool mungkin berupa path absolut. Pastikan memeriksa dan mengubahnya menjadi path relatif, hindari spasi pada nama file, dan pastikan encoding file adalah UTF-8.
- Untuk persyaratan detail tentang format dan spesifikasi model, lihat Persiapan Model.
Tip: Jika masalah masih belum dapat diselesaikan, kemas file model dan log error, lalu dapatkan bantuan melalui forum resmi EasyAR atau dukungan teknis.