Inisialisasi

Tempat melakukan inisialisasi

Inisialisasi SDK sedini mungkin — biasanya saat halaman atau komponen yang berisi frame pengambilan gambar dimuat. Lihat Praktik terbaik untuk penjelasan mengapa Anda sebaiknya tidak melakukan inisialisasi pada klik tombol pengambilan gambar.

Menyematkan kredensial

Implementasikan kelas UnicoConfig dengan kredensial yang disediakan oleh tim Onboarding:

import { UnicoConfig } from "unico-webframe"

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

Buat instance builder

Buat instance baru dari UnicoCheckBuilder:

const unicoCameraBuilder = new UnicoCheckBuilder();

Konfigurasi jalur resource

Tentukan jalur file tambahan (jika ditambahkan ke proyek Anda):

unicoCameraBuilder.setResourceDirectory("/resources");

Tentukan jalur file model AI (hanya diperlukan untuk mode kamera Smart):

unicoCameraBuilder.setModelsPath("https://meusite.com.br/models");

Auto-fetch sejak 3.18.0

Mulai versi 3.18.0, SDK dapat secara otomatis mengambil resource tambahan — cukup jangan implementasikan setResourceDirectory dan pastikan konfigurasi CSP diterapkan dengan benar.

Konfigurasi CSS Reset (opsional)

Secara default, SDK menerapkan CSS Reset untuk memastikan konsistensi visual antar komponen. Untuk mempertahankan gaya CSS aplikasi Anda, nonaktifkan fitur ini:

unicoCameraBuilder.disableCssReset();

Pemilihan environment

Pilihan antara sandbox dan production dibuat saat inisialisasi. Gunakan enum SDKEnvironmentTypes:

SDKEnvironmentTypes.PROD — environment production
SDKEnvironmentTypes.UAT — environment staging

import {
  UnicoCheckBuilder,
  SDKEnvironmentTypes
} from "unico-webframe"

unicoCameraBuilder.setEnvironment(SDKEnvironmentTypes.UAT);

informasi

Jika tidak dikonfigurasi, Web SDK menggunakan environment production secara default.

Untuk daftar lengkap tipe environment yang tersedia, lihat API Reference > Initialization API.

Siklus hidup

Autentikasi SDK dengan backend membutuhkan beberapa detik. Inisialisasi lebih awal, bukan saat pengguna mengklik tombol pengambilan gambar — jika tidak, pengguna akan merasakan jeda antara klik dan pembukaan kamera.