Table of Contents

Pertanyaan umum CRS

Berikut adalah pertanyaan dan jawaban umum saat menggunakan fitur cloud image recognition.

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

A: Ya. CRS mendukung pemuatan model 3D/konten virtual dengan cara berikut:

  • Properti meta: Simpan konten AR di field meta pada gambar target, dalam format file teks. Model 3D dapat dienkode sebagai teks melalui Base64, atau disimpan sebagai URL cloud storage, seperti Alibaba Cloud OSS atau AWS S3.
  • Proses pemuatan: Setelah klien memperoleh data meta dari CRS, klien menggunakan 3D engine, seperti Unity atau Three.js, untuk parsing dan memuat model.
  • Dokumentasi referensi: Lihat Membuat target recognition | POST /targets.
Catatan

Untuk file besar (>2MB), gunakan metode URL untuk menghindari request body terlalu besar akibat encoding Base64.

Q: Apakah CRS memiliki batas jumlah recognition?

A: Tidak ada batas total jumlah recognition, tetapi ada tingkatan concurrency:

  • Mode dasar: Cocok untuk aplikasi dengan QPS < 50. Tidak ada batas keras, tetapi harus mengikuti prinsip fair use.
  • Mode concurrency tinggi: Saat QPS >= 50, disarankan upgrade ke cloud service resource khusus untuk menjamin stabilitas recognition dan latensi rendah.
Penting

Jika aplikasi Anda mungkin menghadapi lonjakan concurrency sementara selama hari libur atau event besar, pastikan menghubungi dukungan teknis EasyAR setidaknya 3 hari kerja sebelumnya untuk mengajukan upgrade layanan.

Q: Mengapa Web Service API mengembalikan 404?

A: Error 404 biasanya berarti path URL yang diminta tidak ada atau resource tidak ditemukan. Penyebab umum adalah sebagai berikut:

  • Format URL salah: Endpoint yang tidak ada diakses. Misalnya, langsung 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 recognition kosong: Saat memanggil interface /search, jika tidak ada target yang cocok, 404 juga dikembalikan, dengan message body No result: there is no matching.

Langkah troubleshooting:

  1. Pastikan ejaan URL benar, termasuk UUID dan port.
  2. Gunakan interface /ping untuk menguji ketersediaan service.
  3. Periksa apakah parameter request lengkap, seperti data gambar dan API Key.

Saran solusi: Jika /search mengembalikan 404, berarti gambar saat ini tidak mengenai target apa pun. Anda dapat mengarahkan pengguna untuk menyesuaikan sudut pengambilan gambar atau memeriksa apakah target telah diunggah ke CRS.

Q: Apa penyebab umum kode response error Web Service API?

A: Selain 404, kode error berikut cukup umum:

  • 400 invalid appId (appKey)

    • Penyebab: Key yang diminta tidak benar, atau verifikasi signature gagal.
    • Troubleshooting: Pastikan Key Anda disalin dari CRS image library; apakah request POST berisi signature lengkap; dan apakah parameter request menggunakan Content-Type: application/json.

  • 400 invalid date

    • Penyebab: Timestamp request tidak valid atau selisihnya terlalu besar dari waktu server, biasanya harus dalam +/-5 menit.
    • Troubleshooting: Periksa apakah waktu perangkat akurat, terutama pengaturan zona waktu.

  • 415 unsupported media type

    • Penyebab: HTTP Header tidak mengatur Content-Type: application/json, atau format request body salah.
    • Troubleshooting: Pastikan Header request POST berisi Content-Type: application/json dan Body adalah JSON yang valid.

Saran umum: Semua request CRS API harus secara ketat mengikuti dokumentasi CRS API.

Catatan: FAQ di atas mencakup masalah yang sering muncul dalam penggunaan CRS. Jika perlu melaporkan masalah baru, silakan beri feedback dan hubungi kami!