Table of Contents

CRS Pertanyaan Umum

Berikut adalah pertanyaan dan jawaban umum dalam penggunaan fitur pengenalan gambar berbasis cloud.

Q: Apakah CRS mendukung pemuatan model 3D/konten virtual dari cloud?

A: Ya, CRS mendukung pemuatan model 3D/konten virtual melalui cara berikut:

  • Properti meta: Menyimpan konten AR di bidang meta gambar target, dalam format file teks. Model 3D dapat dikodekan ke teks menggunakan Base64, atau disimpan sebagai URL penyimpanan cloud (seperti Alibaba Cloud OSS, AWS S3).
  • Alur pemuatan: Setelah klien mendapatkan data meta dari CRS, gunakan mesin 3D (seperti Unity, Three.js) untuk mengurai dan memuat model.
  • Dokumentasi referensi: Lihat Membuat target pengenalan | POST /targets.
Catatan

Untuk file besar (>2MB), gunakan metode URL untuk menghindari ukuran badan permintaan yang berlebihan karena pengkodean Base64.

Q: Apakah CRS memiliki batasan jumlah pengenalan?

A: Tidak ada batasan total jumlah pengenalan, tetapi terdapat tingkat konkurensi:

  • Mode dasar: Cocok untuk aplikasi dengan QPS < 50, tidak ada batasan ketat, tetapi harus mematuhi prinsip penggunaan yang adil.
  • Mode konkurensi tinggi: Jika QPS ≥ 50, disarankan untuk meningkatkan ke layanan cloud sumber daya khusus untuk menjamin stabilitas pengenalan dan latensi rendah.
Penting

Jika aplikasi Anda mungkin mengalami lonjakan konkurensi sementara selama liburan atau acara besar, harap hubungi dukungan teknis EasyAR setidaknya 3 hari kerja sebelumnya untuk meminta peningkatan layanan.

Q: Apa penyebab Web Service API mengembalikan kode 404?

A: Kesalahan 404 biasanya menunjukkan jalur URL yang diminta tidak ada atau sumber daya tidak ditemukan. Penyebab umum meliputi:

  • Format URL salah: Mengakses endpoint yang tidak ada. Contoh: Mengakses http://your_crs_uuid.na1.crs.easyar.com:8888 tidak valid; gunakan endpoint lengkap seperti http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Hasil pengenalan kosong: Saat memanggil antarmuka /search, jika tidak ada target yang cocok, juga akan mengembalikan 404 dengan badan pesan No result: there is no matching.

Langkah pemeriksaan:

  1. Pastikan ejaan URL benar, termasuk UUID dan port.
  2. Gunakan antarmuka /ping untuk menguji ketersediaan layanan.
  3. Periksa apakah parameter permintaan lengkap (seperti data gambar, API Key).

Saran solusi: Jika /search mengembalikan 404, artinya gambar saat ini tidak mengenali target. Arahkan pengguna untuk menyesuaikan sudut pengambilan gambar atau periksa apakah target telah diunggah ke CRS.

Q: Apa penyebab umum kode kesalahan Web Service API?

A: Selain 404, kode kesalahan berikut umum terjadi:

  • 400 invalid appId (appKey)

    • Penyebab: Key yang diminta tidak benar, atau verifikasi tanda tangan gagal.
    • Pemeriksaan: Pastikan Key Anda disalin dari galeri CRS; permintaan POST berisi tanda tangan lengkap; parameter permintaan menggunakan Content-Type: application/json.

  • 400 invalid date

    • Penyebab: Cap waktu permintaan tidak valid atau perbedaan terlalu besar dengan waktu server (biasanya diharapkan ±5 menit).
    • Pemeriksaan: Periksa apakah waktu perangkat akurat (perhatikan setelan zona waktu).

  • 415 unsupported media type

    • Penyebab: HTTP Header tidak menyetel Content-Type: application/json, atau format badan permintaan salah.
    • Pemeriksaan: Pastikan permintaan POST memiliki Header Content-Type: application/json dan Body berupa JSON yang valid.

Saran umum: Semua permintaan API CRS harus mematuhi Dokumentasi API CRS secara ketat.

Penjelasan: FAQ di atas mencakup pertanyaan frekuensi tinggi dalam penggunaan CRS. Jika Anda perlu melaporkan masalah baru, silakan berikan umpan balik dan hubungi kami!