Manajemen gambar target

Gambar target (Targets) dapat dikelola melalui dua cara berikut:

• Manajemen visual: Login ke pusat pengembangan EasyAR untuk pemeliharaan manual.
• Manajemen otomatisasi API: Dengan memanggil Web Service REST API untuk diintegrasikan ke dalam sistem bisnis atau backend manajemen sendiri.

[!Penting] Dalam layanan pengenalan awan, manajemen gambar target dan pengenalan gambar adalah dua kebutuhan berbeda, API sesuai dengan dua entri Cloud URL yang berbeda.

Pemilihan wilayah pusat data

Wilayah pusat data tempat contoh operasi galeri berjalan mendukung pilihan berikut:

• China-Shanghai
• Amerika-Silicon Valley

Metode 1: Mengelola gambar target di pusat pengembangan EasyAR

Cocok untuk pengujian skala kecil atau unggah cepat manual. Langkah-langkah operasional:

1. Login ke pusat pengembangan EasyAR, masuk ke manajemen pengenalan awan.
2. Pilih wilayah target. Jika Anda belum membuat galeri, harap buat baru dan aktifkan galeri pengenalan awan.
3. Klik kelola di daftar galeri, lalu masuk ke antarmuka pemeliharaan gambar target untuk mengunggah, mengubah, atau menghapus.

Metode 2: Menggunakan REST API untuk manajemen otomatisasi

Untuk aplikasi yang perlu menangani banyak gambar target, disarankan menggunakan Web Service REST API, untuk mengimplementasikan alur otomatisasi di aplikasi atau backend manajemen Anda.

Daftar persiapan

Berikut adalah daftar yang perlu dipersiapkan. Sebelum Anda mulai mengelola gambar target, Anda perlu menyiapkan instance database pengenalan awan baru (Cloud Database)

• CRS AppId
• API Key / API Secret atau Token
• Cloud URL
  • Server-end URL: Alamat URL manajemen gambar target, https menggunakan port 443
  • Client-end URL: Alamat URL layanan pengenalan gambar, https menggunakan port 8443

[!Penting] Penjelasan perbedaan port: Entri API manajemen target (443) dan entri API pengenalan awan yang dipanggil oleh mobile/Unity (8443) adalah dua saluran berbeda, harap pastikan untuk membedakannya saat konfigurasi.

Cara mendapatkan setiap item dalam daftar

• Cara melihat CRS AppId:
  Pusat pengembangan -> Manajemen pengenalan awan -> Pilih galeri -> Kelola -> Kunci

• Cara melihat API Key / API Secret:
  Pusat pengembangan -> APIKey layanan awan -> Salin

    Jika Anda belum memiliki API Key, buat APIKey, harus memilih izin pengenalan awan (CRS). Pelajari lebih lanjut tentang API Key dan kontrol izin, lihat topik Pengantar API Key

• Cara melihat Token:
  Pusat pengembangan -> APIKey layanan awan -> Kelola -> Pilih masa berlaku -> Hasilkan Token -> Salin

    Jika Anda perlu menyesuaikan masa berlaku Token, Anda dapat merujuk ke cara UAC API —— Membuat Token, menggunakan APIKey dan APISecret asli untuk membuat Token

• Cara melihat Cloud URL:
  Manajemen gambar target di galeri menggunakan Server-end URL port 443, Server-end URL
  Pusat pengembangan -> Manajemen pengenalan awan -> Pilih galeri -> Kelola -> Kunci -> Manajemen galeri

Panduan integrasi multi-perangkat

Dalam alur kerja aktual, manajemen gambar target biasanya diintegrasikan di server bisnis pengembang, atau di mobile atau Unity:

• Platform layanan bisnis: Menyediakan contoh kode panggilan API untuk bahasa pengembangan server umum (Curl/Java/NodeJS/PHP), membantu pengembang mengimplementasikan unggah otomatis gambar target dan pembaruan metadata (Meta).

• Perangkat mobile (Unity/Mobile): Menyediakan contoh kode manajemen gambar target berbasis Unity, pengembang mengimplementasikan cara mengunggah gambar target dengan mengambil foto sendiri.

Menjalankan contoh kode

Berikut adalah contoh penggunaan kode Java, di kode contoh isi dengan item daftar persiapan Anda sendiri, lalu jalankan Main

Topik terkait:

• Pengantar APIs pengenalan awan
• Pengantar API Key

Topik selanjutnya:

• Evaluasi kesulitan pengenalan gambar
• Membuat gambar target

[!Catatan] Dalam alur kerja aktual, pembuatan gambar target disarankan mengikuti implementasi terbaik, disarankan untuk membaca dengan saksama.