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

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

# 回调 / 监听器接口

UnicoListener（生命周期）
| 方法 | 触发条件 |
| --- | --- |
| `onErrorUnico(UnicoError error)` | SDK 操作过程中发生实现错误 |
| `onUserClosedCameraManually()` | 用户手动关闭摄像头 |
| `onSystemClosedCameraTimeoutSession()` | 会话超时（默认：45 秒） |
| `onSystemChangedTypeCameraTimeoutFaceInference()` | 13 秒内未检测到人脸 — 切换为手动拍摄 |

UnicoSelfie（自拍回调）
| 方法 | 触发条件 |
| --- | --- |
| `onSuccessSelfie(ResultCamera result)` | 自拍采集成功 |
| `onErrorSelfie(UnicoError error)` | 自拍采集失败 |

UnicoSdks（User Journey 回调）
| 方法 | 触发条件 |
| --- | --- |
| `onSuccess(SuccessResult result)` | Journey 流程完成 — 返回 `processId`（仅限 User Journeys） |
| `onErrorSelfie(UnicoError error)` | 自拍采集失败 |

UnicoDocument（文件回调）
| 方法 | 触发条件 |
| --- | --- |
| `onSuccessDocument(ResultCamera result)` | 文件采集成功 |
| `onErrorDocument(UnicoError error)` | 文件采集失败 |

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