Initialisierung

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.

Anmeldedaten einbetten

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

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:

const unicoCameraBuilder = new UnicoCheckBuilder();

Ressourcenpfade konfigurieren

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

unicoCameraBuilder.setResourceDirectory("/resources");

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

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

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 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:

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

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

unicoCameraBuilder.setEnvironment(SDKEnvironmentTypes.UAT);

Information

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.

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.