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

## Wo zu initialisieren

Initialisieren Sie das SDK so früh wie möglich — in der Regel beim Laden der Seite oder der Komponente, die den Aufnahmerahmen enthält. Weitere Informationen dazu, warum Sie die Initialisierung **nicht** beim Klick auf die Aufnahmeschaltfläche durchführen sollten, finden Sie unter [Best Practices](/dual-api/developers/sdks-and-tools/web/web-sdk/resources).

## Anmeldedaten einbetten

Implementieren Sie die Klasse `UnicoConfig` mit den vom Onboarding-Team bereitgestellten Anmeldedaten:

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

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

## Builder instanziieren

Erstellen Sie eine neue Instanz von `UnicoCheckBuilder`:

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

## Ressourcenpfade konfigurieren

Geben Sie den Pfad der zusätzlichen Dateien an (sofern Ihrem Projekt hinzugefügt):

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

Geben Sie den Pfad der KI-Modelldateien an (nur für den Smart-Kameramodus erforderlich):

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

:::info[Automatisches Abrufen ab 3.18.0]
Ab Version 3.18.0 kann das SDK die zusätzlichen Ressourcen automatisch abrufen — implementieren Sie `setResourceDirectory` einfach nicht und stellen Sie sicher, dass die [CSP-Konfiguration](/dual-api/developers/sdks-and-tools/web/web-sdk/installation) korrekt angewendet wird.
:::

## CSS-Reset konfigurieren (optional)

Standardmäßig wendet das SDK einen CSS-Reset an, um die visuelle Konsistenz über alle Komponenten hinweg sicherzustellen. Um die CSS-Stile Ihrer Anwendung beizubehalten, deaktivieren Sie diese Funktion:

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

## Umgebungsauswahl

Die Wahl zwischen **Sandbox** und **Produktion** wird während der Initialisierung getroffen. Verwenden Sie das Enum `SDKEnvironmentTypes`:

- `SDKEnvironmentTypes.PROD` — Produktionsumgebung
- `SDKEnvironmentTypes.UAT` — Staging-Umgebung

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

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

:::info
Wenn keine Konfiguration vorgenommen wird, verwendet das Web SDK standardmäßig die Produktionsumgebung.
:::

Die vollständige Liste der verfügbaren Umgebungstypen finden Sie unter [API-Referenz > Initialisierungs-API](/dual-api/developers/sdks-and-tools/web/web-sdk/api-reference/initialization-api).

## Lebenszyklus

Die SDK-Authentifizierung mit dem Backend dauert einige Sekunden. **Initialisieren Sie frühzeitig**, nicht wenn der Benutzer auf die Aufnahmeschaltfläche klickt — andernfalls erlebt der Benutzer eine Verzögerung zwischen dem Klick und dem Öffnen der Kamera.