---
title: 回调/监听器接口
canonical: https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/api-reference/callback-listener-interfaces
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- [SDK 与工具](/zh-CN/developers/sdks-and-tools/overview)
- [Android SDK](/zh-CN/developers/sdks-and-tools/android/requirements)
- API 参考
- 回调/监听器接口

# 回调/监听器接口

AcessoBioListener
SDK 会话的生命周期回调。将实现传递给 `AcessoBio` 构造函数。

| 方法 | 触发条件 |
| --- | --- |
| `onErrorAcessoBio(error: ErrorBio)` | 会话期间发生错误 |
| `onUserClosedCameraManually()` | 用户手动关闭摄像头 |
| `onSystemClosedCameraTimeoutSession()` | 会话因超时而过期 |
| `onSystemChangedTypeCameraTimeoutFaceInference()` | 等待人脸对齐超时导致会话超时 |

iAcessoBioSelfie
自拍采集的回调。将实现传递给 `UnicoCheckCameraOpener.Camera.open()`。

| 方法 | 触发条件 |
| --- | --- |
| `onSuccessSelfie(result: ResultCamera)` | 自拍采集成功 |
| `onSuccess(result: SuccessResult)` | 用户旅程完成 — 返回 `processId` |
| `onErrorSelfie(error: ErrorBio)` | 自拍采集期间发生错误 |

iAcessoBioDocument
文件采集的回调。将实现传递给 `UnicoCheckCameraOpener.Document.open()`。

| 方法 | 触发条件 |
| --- | --- |
| `onSuccessDocument(result: ResultCamera)` | 文件采集成功 |
| `onErrorDocument(error: String)` | 文件采集期间发生错误 |

CameraListener
自拍摄像头准备阶段的回调。传递给 `prepareCamera()`。

| 方法 | 触发条件 |
| --- | --- |
| `onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera)` | 摄像头已就绪 — 调用 `cameraOpener.open(listener, webAppToken)` 开始采集 |
| `onCameraFailed(message: String)` | 摄像头准备失败 |

DocumentCameraListener
文件摄像头准备阶段的回调。传递给 `prepareDocumentCamera()`。

| 方法 | 触发条件 |
| --- | --- |
| `onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document)` | 摄像头已就绪 — 调用 `cameraOpener.open(documentType, listener)` 开始采集 |
| `onCameraFailed(message: String)` | 摄像头准备失败 |

最后更新 于 **2026年10月19日**