---
title: 采集 API
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/flutter/api-reference/capture-api
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- [SDK 与工具](/zh-CN/dual-api/developers/sdks-and-tools/overview)
- [Flutter SDK](/zh-CN/dual-api/developers/sdks-and-tools/flutter/requirements)
- API 参考
- 采集 API

# 采集 API

启动会话的方法
| 方法 | 说明 |
| --- | --- |
| `openCameraSelfie({listener})` | 打开自拍摄像头 |
| `openCameraSelfie({listener, prepareInfo})` | 打开自拍摄像头，附带 `UnicoCheckPrepareInfo` 元数据 |
| `openCameraDocument({documentType, listener})` | 打开文件摄像头，使用指定的 `DocumentCameraTypes` |

采集选项 / 参数
**`UnicoCheckPrepareInfo`** — 用于标识用户会话的元数据。

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `externalUserId` | `String` | 是 | 您系统中的用户标识符。传输前使用 SHA-256 进行哈希处理。 |
| `useCase` | `String` | 否 | 当前运行的上下文或流程的标识符。以明文传输。 |

**`DocumentCameraTypes`** — 参见[枚举](/zh-CN/developers/sdks-and-tools/flutter/api-reference/enums)。

结果类型与字段
**`ResultCamera`** — 采集成功（自拍或文件）时返回的对象。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `base64` | `String` | Base64 格式的采集图像 |
| `encrypted` | `String` | 待发送至后端的 JWT |

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