Dokumentenerfassung

Erfassung von Ausweisdokumenten. Das SDK zeigt einen Rahmen, der dem Benutzer beim Positionieren des Dokuments hilft. Nach dem Positionieren klickt der Benutzer auf die Schaltfläche, um das Foto aufzunehmen.

Keine Inhaltsvalidierung

Das SDK führt keine Validierung des erfassten Inhalts durch.

Verfügbare Dokumentenrahmen

Rahmen	Beschreibung
`DocumentEnums.CPF`	CPF erfassen
`DocumentEnums.CNH`	Offene CNH erfassen
`DocumentEnums.cnhFrente`	Vorderseite der CNH erfassen
`DocumentEnums.cnhVerso`	Rückseite der CNH erfassen
`DocumentEnums.RG`	Offenes RG erfassen
`DocumentEnums.rgFrente`	Vorderseite des RG erfassen
`DocumentEnums.rgVerso`	Rückseite des RG erfassen
`DocumentEnums.none`	Generischer rechteckiger Rahmen für beliebige andere Dokumente

Generischer Rahmen

Wenn Sie ein Dokument erfassen müssen, für das kein spezifischer Rahmen vorhanden ist (z. B. RNE), verwenden Sie DocumentEnums.none — ein generischer, rechteckiger Rahmen, der für jede Erfassung verwendet werden kann.

Die vollständige Liste der unterstützten Dokumenttypen finden Sie unter API-Referenz > Enums.

Dokumentenerfassung starten

Schritt 1 — AcessoBioManagerDelegate implementieren

AcessoBioManagerDelegate verwaltet die Lifecycle-Callbacks des SDKs. Implementieren Sie die vier obligatorischen Methoden:

Methode	Wann sie aufgerufen wird
`onErrorAcessoBioManager(error)`	Ein Fehler ist während des SDK-Betriebs aufgetreten
`onUserClosedCameraManually()`	Der Benutzer hat die Kamera manuell geschlossen
`onSystemClosedCameraTimeoutSession()`	Das 40-Sekunden-Sitzungslimit wurde erreicht
`onSystemChangedTypeCameraTimeoutFaceInference()`	Kein Gesicht für 13 Sekunden erkannt — wechselt zur manuellen Aufnahme

Swift
Objective-C

class ViewController: UIViewController, AcessoBioManagerDelegate {
  var unicoCheck: AcessoBioManager!

  override func viewDidLoad() {
    super.viewDidLoad()
    unicoCheck = AcessoBioManager(viewController: self)
  }

  func onErrorAcessoBioManager(_ error: ErrorBio!) { }
  func onUserClosedCameraManually() { }
  func onSystemClosedCameraTimeoutSession() { }
  func onSystemChangedTypeCameraTimeoutFaceInference() { }
}

@implementation ViewController: UIViewController
- (void)viewDidLoad {
    [super viewDidLoad];
    unicoCheck = [[AcessoBioManager alloc]initWithViewController:self];
}

- (void)onErrorAcessoBioManager:(ErrorBio *)error { }
- (void)onSystemChangedTypeCameraTimeoutFaceInference { }
- (void)onSystemClosedCameraTimeoutSession { }
- (void)onUserClosedCameraManually { }
@end

Obligatorische Delegate-Methoden

Alle vier oben genannten Delegate-Methoden müssen in Ihrem Projekt erstellt werden (auch ohne Logik). Andernfalls wird das Projekt nicht erfolgreich kompiliert.

Schritt 2 — DocumentCameraDelegate und AcessoBioDocumentDelegate implementieren

Diese Delegates verarbeiten die Rückrufe für das Ergebnis der Dokumentenerfassung:

Methode	Beschreibung
`onSuccessDocument(result)`	Erfassung erfolgreich — gibt `DocumentResult` mit `base64` (Vorschau) und `encrypted` (JWT für die API) zurück
`onErrorDocument(errorBio)`	Erfassung fehlgeschlagen — gibt ein `ErrorBio` mit Code und Beschreibung zurück

Swift
Objective-C

class ViewController: UIViewController, AcessoBioManagerDelegate,
  DocumentCameraDelegate, AcessoBioDocumentDelegate {

  func onSuccessDocument(_ result: DocumentResult!) { }
  func onErrorDocument(_ errorBio: ErrorBio!) { }
}

// .h
@interface ViewController: UIViewController <AcessoBioManagerDelegate,
  DocumentCameraDelegate, AcessoBioDocumentDelegate> {
  AcessoBioManager *unicoCheck;
}

// .m
- (void)onSuccessDocument:(DocumentResult *)result {
    NSLog(@"%@", result.base64);
}

- (void)onErrorDocument:(ErrorBio *)errorBio { }

Schritt 3 — prepareDocumentCamera und openDocument aufrufen

Rufen Sie prepareDocumentCamera auf und übergeben die SDK-Konfiguration. Sobald die Kamera bereit ist, wird onCameraReadyDocument mit einem AcessoBioCameraOpenerDelegate ausgelöst — öffnen Sie die Kamera mit openDocument() und übergeben die gewünschten DocumentEnums:

onCameraReadyDocument(cameraOpener) — Kamera ist bereit; rufen Sie openDocument(.CNH, delegate: self) auf.
onCameraFailedDocument(message) — Kameravorbereitung fehlgeschlagen (ErrorPrepare ist eine Erweiterung von ErrorBio).

Swift
Objective-C

@IBAction func openCamera(_ sender: Any) {
  unicoCheck.build().prepareDocumentCamera(self, config: YourUnicoConfigClass())
}

func onCameraReadyDocument(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
  cameraOpener.openDocument(DocumentEnums.CNH, delegate: self)
}

func onCameraFailedDocument(_ message: ErrorPrepare!) { }

- (IBAction)openCamera:(UIButton *)sender {
    [[unicoCheck build] prepareDocumentCamera:self config:[YourUnicoConfigClass new]];
}

- (void)onCameraReadyDocument:(id)cameraOpener {
    [cameraOpener openDocument:DocumentCNH delegate:self];
}

- (void)onCameraFailedDocument:(ErrorPrepare *)message { }

Die vollständige Ergebnisverarbeitung finden Sie unter Ergebnis empfangen.