---
title: 活体检测
description: 验证用户在自拍采集时真实在场且存活的能力。几乎所有 IDCloud 流程的生物特征基础。
canonical: https://developer.unico.io/zh-CN/dual-api/capabilities/liveness
locale: zh-CN
generated_by: markdown-export
---

当用户参与身份验证流程时，活体检测是第一个运行的能力。

### 功能说明

检测采集到的自拍照片是否来自摄像头前的真实人物，而非照片、视频、面具或任何其他注入攻击。它与 SDK 或 Unico 的 Web Journey 配合工作，引导用户直到获取生物特征有效的帧。

### 输入

采集由 SDK 或 Web Journey 处理——您无需手动将图像发送到活体检测。输入是通过 [`POST /v1/process`](/dual-api/developers/api-reference/web-sdk) 开启的、包含活体检测流程的会话。

:::warning[API 集成需要 SDK]
要在 headless API 集成中使用活体检测，必须实现 Unico 的某款 SDK（Web、Android、iOS 或 Flutter）——活体检测不能仅通过 API 使用 base64 图像单独调用。
:::

### 可能的响应

| 响应 | 含义 |
|---|---|
| `YES` | 用户为真实在场。 |
| `NO` | 活体检测失败。 |

:::tip[API 枚举值]
在 Web 和 Native 合约响应中，这些值映射到 `authenticationInfo.livenessResult` 字段中的 `LIVENESS_RESULT_LIVE`（`YES`）和 `LIVENESS_RESULT_NOT_LIVE`（`NO`）。完整枚举表请参见[获取流程](/dual-api/developers/api-reference/web-sdk/get-process)。
:::

### 可用性

| 接入方式 | 是否支持 |
|---|:-:|
| **SDK**（Android、iOS、Flutter） | ✅ |
| **Web**（iFrame、Redirect） | ✅ |
| **API**（headless，无 SDK） | ⚠️ 采集需要 Unico SDK |

### 有效组合

活体检测几乎出现在目录中的每个流程中：

`idlive`, `id`, `idlivetrust`, `idtrust`, `idcheck`, `idchecktrust`, `iddocs`, `idsign`, `iddocssign`, `idchecktrustdocs`, `idchecktrustsign`, `idchecktrustdocssign`, `idtrustdocs`, `idtrustsign`, `idtrustdocssign`, `idunicodocs`, `idunicosign`, `idunicodocssign`, `idunicoserprodocssign`, `idcheckserpro`, `idcheckserprodocs`, `idcheckserprodocssign`, `creditoconsignado`, `idtoken`, `idtokentrust`, `idtokensign`.

完整矩阵请参见[可用流程](/dual-api/capabilities/available-flows)。

:::tip[唯一不包含活体检测的流程]
`idsmart`（智能重新验证）——用元数据/passkey 验证加上之前采集的生物特征替代主动采集。
:::

### 使用此能力的产品

- [Onboarding](/products/sign-up/onboarding/index)
- [无文件验证](/products/sign-up/non-document-verification/index)
- [年龄验证](/products/regional-solutions/age-verification/index)