文件采集

采集身份证件。支持 RG（仅正面或正反面）、CNH（正反面）以及 CPF，需结合文件采集与复用能力使用。

有关支持的文件类型及其枚举值的完整列表，请参阅 API 参考 > 枚举。

开始文件采集

步骤 1 — 实现 AcessoBioListener

AcessoBioListener 负责处理 SDK 生命周期回调。请实现以下四个必需方法：

方法	调用时机
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 并实现两个监听器后，调用 prepareDocumentCamera，传入 SDK 配置（在初始化中创建的 UnicoConfig）、所需的 DocumentType 以及 DocumentCameraListener：

• onCameraReady — 摄像头已就绪；调用 open 并传入步骤 2 中的 documentListener。
• 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) { }
  });

有关完整的结果处理，请参阅接收结果。