Захват документов

Захват документов, удостоверяющих личность. Поддерживает RG (только лицевая сторона или лицевая и обратная), CNH (лицевая и обратная) и CPF при использовании совместно с возможностью Захват и повторное использование документов.

Полный список поддерживаемых типов документов и их значений перечисления см. в разделе Справочник API > Перечисления.

Начало захвата документа

Шаг 1 — Реализуйте AcessoBioListener

AcessoBioListener обрабатывает callback-и жизненного цикла SDK. Реализуйте четыре обязательных метода:

Метод	Когда вызывается
`onErrorAcessoBio(errorBio)`	Произошла ошибка во время работы SDK
`onUserClosedCameraManually()`	Пользователь вручную закрыл камеру
`onSystemClosedCameraTimeoutSession()`	Достигнут лимит времени сессии — см. Ограничения сессии
`onSystemChangedTypeCameraTimeoutFaceInference()`	Достигнут лимит времени распознавания лица — переключение на ручной захват — см. Ограничения сессии

Kotlin
Java

val callback = object : AcessoBioListener {
  override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
  override fun onUserClosedCameraManually() { }
  override fun onSystemClosedCameraTimeoutSession() { }
  override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}

AcessoBioListener callback = new AcessoBioListener() {
  @Override
  public void onErrorAcessoBio(ErrorBio errorBio) { }

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

Шаг 2 — Реализуйте iAcessoBioDocument

iAcessoBioDocument обрабатывает обратные вызовы результата захвата документа:

Метод	Описание
`onSuccessDocument(result)`	Захват выполнен успешно — возвращает `ResultCamera` с `base64` (предпросмотр) и `encrypted` (JWT для API)
`onErrorDocument(errorBio)`	Захват не выполнен — возвращает `ErrorBio` с кодом и описанием

Kotlin
Java

val documentListener = object : iAcessoBioDocument {
  override fun onSuccessDocument(result: ResultCamera?) { }
  override fun onErrorDocument(errorBio: ErrorBio?) { }
}

iAcessoBioDocument documentListener = new iAcessoBioDocument() {
  @Override
  public void onSuccessDocument(ResultCamera result) { }

  @Override
  public void onErrorDocument(ErrorBio errorBio) { }
};

Шаг 3 — Вызовите prepareDocumentCamera

После инициализации acessoBioBuilder и реализации обоих обработчиков вызовите prepareDocumentCamera, передав конфигурацию SDK (UnicoConfig, созданный в разделе Инициализация), желаемый DocumentType и DocumentCameraListener:

onCameraReady — камера готова; вызовите open, передав documentListener из шага 2.
onCameraFailed — подготовка камеры завершилась ошибкой; обработайте сообщение об ошибке.

Kotlin
Java

acessoBioBuilder
  .build()
  .prepareDocumentCamera(UnicoConfig(), DocumentType.CNH, object : DocumentCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document?) {
      cameraOpener?.open(documentListener)
    }
    override fun onCameraFailed(message: String?) { }
  })

acessoBioBuilder
  .build()
  .prepareDocumentCamera(new UnicoConfig(), DocumentType.CNH, new DocumentCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Document cameraOpener) {
      cameraOpener.open(documentListener);
    }

    @Override
    public void onCameraFailed(String message) { }
  });

Полную информацию об обработке результата см. в разделе Получение результата.