ドキュメントキャプチャ

本人確認書類のキャプチャ。ドキュメントキャプチャと再利用機能と組み合わせることで、RG（表面のみ、または表裏）、CNH（表裏）、CPF に対応しています。

サポートされているドキュメントタイプとその enum 値の一覧については、API リファレンス > Enum をご参照ください。

ドキュメントキャプチャの開始

ステップ 1 — AcessoBioListener を実装する

AcessoBioListener は SDK ライフサイクルコールバックを処理します。4 つの必須メソッドを実装してください:

メソッド	呼び出されるタイミング
onErrorAcessoBio(errorBio)	SDK 操作中にエラーが発生した
onUserClosedCameraManually()	ユーザーが手動でカメラを閉じた
onSystemClosedCameraTimeoutSession()	セッションの制限時間に達した — セッション制限を参照
onSystemChangedTypeCameraTimeoutFaceInference()	顔推論の制限時間に達した — 手動キャプチャに切り替わる — セッション制限を参照

Kotlin

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

Java

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)	キャプチャ成功 — base64（プレビュー）と encrypted（API 用 JWT）を含む ResultCamera を返す
onErrorDocument(errorBio)	キャプチャ失敗 — コードと説明を含む ErrorBio を返す

Kotlin

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

Java

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

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

ステップ 3 — prepareDocumentCamera を呼び出す

acessoBioBuilder を初期化し、両方のリスナーを実装したら、SDK 設定（初期化で作成した UnicoConfig）、希望する DocumentType、および DocumentCameraListener を渡して prepareDocumentCamera を呼び出します：

• onCameraReady — カメラの準備完了；ステップ 2 の documentListener を渡して open を呼び出す。
• onCameraFailed — カメラの準備失敗；エラーメッセージを処理する。

Kotlin

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

Java

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) { }
  });

結果の完全な処理については、結果の受け取り をご参照ください。