---
title: Inisialisasi
canonical: https://developer.unico.io/id/dual-api/developers/sdks-and-tools/web/web-sdk/initialization
locale: id
generated_by: markdown-export
---

## Tempat melakukan inisialisasi

Inisialisasi SDK sedini mungkin — biasanya saat halaman atau komponen yang berisi frame pengambilan gambar dimuat. Lihat [Praktik terbaik](/dual-api/developers/sdks-and-tools/web/web-sdk/resources) 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:

```javascript
import { UnicoConfig } from "unico-webframe"

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

## Buat instance builder

Buat instance baru dari `UnicoCheckBuilder`:

```javascript
const unicoCameraBuilder = new UnicoCheckBuilder();
```

## Konfigurasi jalur resource

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

```javascript
unicoCameraBuilder.setResourceDirectory("/resources");
```

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

```javascript
unicoCameraBuilder.setModelsPath("https://yoursite.com/models");
```

:::info[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](/dual-api/developers/sdks-and-tools/web/web-sdk/installation) 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:

```javascript
unicoCameraBuilder.disableCssReset();
```

## Pemilihan environment

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

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

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

unicoCameraBuilder.setEnvironment(SDKEnvironmentTypes.UAT);
```

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

Untuk daftar lengkap tipe environment yang tersedia, lihat [API Reference > Initialization API](/dual-api/developers/sdks-and-tools/web/web-sdk/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.