蓝亭书序
2026-11-18 14:47:48 发布什么是活体检测?
人脸活体检测是指在一些身份验证场景中,确定对象真实生理特征的方法。
在人脸识别应用中,活体检测能实时捕捉人脸或者通过眨眼、张嘴、摇头、点头等组合动作。
动作活体检测支持实时捕捉人脸,需要用户配合做指定动作就可以判断是真实活体,还是非活体攻击(比如:打印图片、人脸翻拍视频以及人脸面具等)。
使用人脸关键点定位和人脸追踪等技术,验证用户是否为真实活体本人操作,可有效抵御照片、视频、面具、遮挡以及屏幕翻拍等常见的攻击手段,从而帮助用户甄别欺诈行为,保障用户的利益。
效果如下:

interactiveLiveness
鸿蒙为开发者提供了一套基于端侧的活体检测方案,由interactiveLiveness模块提供。
核心接口有两个,一个用于唤起人脸检测服务、一个用于获取检测结果
// 跳转到人脸活体检测页面的入口。使用Promise异步回调。
startLivenessDetection(config: InteractiveLivenessConfig): Promise<boolean>
// 获取人脸活体检测的结果。使用Promise异步回调。
getInteractiveLivenessResult(): Promise<InteractiveLivenessResult>其中入参InteractiveLivenessConfig类型定义如下:
class InteractiveLivenessConfig {
// 表示的是人脸活体检测模式,默认动作活体检测模式。INTERACTIVE_MODE表示动作活体检测模式。
isSilentMode: DetectionMode;
/*
表示动作活体检测的动作数量,数量范围3或4个,默认3个动作。随机生成,
规则如下:
当actionsNum=3时,[眨眼,注视]组合中的动作元素不会同时存在并且相邻的动作元素不会相同。
当actionsNum=4时,眨眼动作元素有且仅有1次,注视动作元素最多出现1次,[眨眼,注视]组合中的动作元素不会相邻,相邻的动作元素不会相同。
该参数只有当isSilentMode是INTERACTIVE_MODE的时候有效。
*/
actionsNum?: ActionsNumber;
// 表示人脸活体检测成功后跳转的页面路径。如果不填,系统有默认的检测成功页面。
failedRouteUrl?: string;
// 表示人脸活体检测失败后跳转的页面路径。如果不填,系统有默认的检测失败页面。
successfulRouteUrl?: string;
// 人脸活体检测完成后跳转模式。默认使用router.replaceUrl。
// BACK_MODE: back 表示人脸活体检测完成后使用router.back返回到上一页。
// REPLACE_MODE: replace 表示人脸活体检测完使用router.replaceUrl跳转。
routeMode?: RouteRedirectionMode;
/*
挑战值。仅用于安全摄像头场景(对应initializeAttestContext方法中的“userData”字段)的活体检测。
长度范围是16-128之间(challenge传空或者undefined表示不使用安全摄像头)。
*/
challenge?: string;
/*
语音播报的开关。
true表示开启语音播报。
false表示关闭语音播报。
默认开启语音播报。
*/
speechSwitch?: boolean;
/*
是否设置隐私模式。
true:设置隐私模式。
false:不设置隐私模式。
默认值为false。
*/
isPrivacyMode?: boolean;
}其中获取监测结果的InteractiveLivenessResult类型定义如下:
class InteractiveLivenessResult {
// 活体检测模式的枚举值。
// INTERACTIVE_LIVENESS 0 表示当前检测的结果是动作活体检测。
// SILENT_LIVENESS 1 表示当前检测的结果是静默活体检测,暂未支持。
// NOT_LIVENESS 2 表示当前检测的结果是非活体,跳转的是失败页面,不会返回错误信息。如果配置了失败页面或者back路由跳转,不建议有重新检测的场景。
livenessType: LivenessType;
// 检测成功后返回最具有活体特征的图片。
mPixelMap?: image.PixelMap;
// 安全摄像头场景返回的安全流。
securedImageBuffer?: ArrayBuffer;
// 安全摄像头场景返回的证书链。
certificate?: Array<string>;
}获取结果可能失败,我们可以通过catch捕获其错误码,常见的错误码如下:
- 1008302000【错误描述】检测算法初始化未完成,无检测数据返回。【可能原因】获取结果时还未进行活体检测。【处理办法】调用活体检测API后,再获取结果。
- 1008302001【错误描述】检测超时,跳转失败页面。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测时,长时间没有按照提示完成相关动作,导致检测超时了。【处理办法】检测时请按提示完成相关动作。
- 1008302002【错误描述】动作错误,跳转失败页面。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测时,没有按照提示完成相关动作,导致检测失败了。【处理办法】检测时请按提示完成相关动作。
- 1008302003【错误描述】连续性检测失败,跳转失败页面。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测多个动作时,没有按照提示完成相关动作,导致连续性检测失败了。【处理办法】检测时请按提示完成相关动作。
- 1008302004【错误描述】检测未完成。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测过程中退出检测。【处理办法】检测时请按提示完成相关动作。
需要注意,使用活体检测功能时,由于需要调用摄像头,需要申明摄像头权限,同时,模拟器中暂时不支持此能力。
"requestPermissions":[
{
"name": "ohos.permission.CAMERA",
"reason": "$string:camera_desc",
"usedScene": {"abilities": []}
}
]示意如下:

Demo案例
实现一个案例,点击开始检测,跳转到活体检测界面,检测完成后回到页面,显示出成功与否。
效果如下:

代码如下(88 ~ 96行 启动检测的代码,117 ~ 126 获取结果的代码):
import { common, abilityAccessCtrl, Permissions } from '@kit.AbilityKit';
import { interactiveLiveness } from '@kit.VisionKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 默认的错误码,表示还未唤起活体检测服务就获取结果
const DEFAULT_ERROR_CODE = 1008302000;
interface FailResultType {
code: number;
message: string;
}
function getDefaultFailResult(): FailResultType {
return {
"code": DEFAULT_ERROR_CODE,
"message": ""
};
}
function getDefaultResultInfo(): interactiveLiveness.InteractiveLivenessResult {
return {
livenessType: 0
};
}
@Entry
@Component
export struct Index {
private context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
private array: Array<Permissions> = ["ohos.permission.CAMERA"];
@State resultInfo: interactiveLiveness.InteractiveLivenessResult = getDefaultResultInfo();
@State failResult: FailResultType = getDefaultFailResult();
onPageShow() {
this.resetResult();
this.getDetectionResultInfo();
}
private getResultMsg() {
// 有活体检测结果
if (this.resultInfo.mPixelMap) {
return '活体检测成功';
}
// 还未唤起活体检测
if (this.failResult.code === DEFAULT_ERROR_CODE) {
return '';
}
return '活体检测失败';
}
@Builder
ShowResultInfo() {
Text(this.getResultMsg())
.width("100%")
.height(26)
.fontSize(20)
.fontColor("#000000")
.fontFamily("HarmonyHeiTi")
.margin({ top: 50 })
.textAlign(TextAlign.Center)
.fontWeight("Medium")
.margin({ bottom: 240 })
if (this.failResult.code != DEFAULT_ERROR_CODE) {
Text(this.failResult.message as string)
.width("100%")
.height(26)
.fontSize(16)
.fontColor(Color.Gray)
.textAlign(TextAlign.Center)
.fontFamily("HarmonyHeiTi")
.fontWeight("Medium")
.margin({ bottom: 200 })
}
}
build() {
Column() {
this.ShowResultInfo()
Button("开始检测", { type: ButtonType.Normal, stateEffect: true })
.width(192)
.height(40)
.fontSize(16)
.backgroundColor(0x317aff)
.borderRadius(20)
.margin({
bottom: 56
})
.onClick(() => {
this.startDetection();
})
}
}
// 跳转到人脸活体检测控件
routerLibrary() {
if (canIUse("SystemCapability.AI.Component.LivenessDetect")) {
// 跳转到活体检测服务
interactiveLiveness.startLivenessDetection({
isSilentMode: 'INTERACTIVE_MODE' as interactiveLiveness.DetectionMode,
routeMode: 'back' as interactiveLiveness.RouteRedirectionMode,
actionsNum: 4 // 检测4个动作,默认是3个
}).then((DetectState: boolean) => {
console.info(`跳转成功`);
}).catch((err: BusinessError) => {
console.error(`跳转失败. 错误码:${err.code},信息:${err.message}`);
})
} else {
// 当前API不支持此能力
}
}
// 校验CAMERA权限
private startDetection() {
abilityAccessCtrl.createAtManager().requestPermissionsFromUser(this.context, this.array).then((res) => {
for (let i = 0; i < res.permissions.length; i++) {
if (res.permissions[i] === "ohos.permission.CAMERA" && res.authResults[i] === 0) {
this.routerLibrary();
}
}
}).catch((err: BusinessError) => {
console.error(`权限申请失败. 错误码 ${err.code}, 信息 ${err.message}`);
})
}
// 获取验证结果
private getDetectionResultInfo() {
// getInteractiveLivenessResult接口调用完会释放资源
if (canIUse("SystemCapability.AI.Component.LivenessDetect")) {
let resultInfo = interactiveLiveness.getInteractiveLivenessResult();
resultInfo.then(data => {
console.log('获取结果成功 ' + JSON.stringify(data))
this.resultInfo = data;
}).catch((err: BusinessError) => {
this.failResult = {
"code": err.code,
"message": err.message
}
})
} else {
// 当前API不支持此能力
}
}
// result release
private resetResult() {
this.resultInfo = getDefaultResultInfo();
this.failResult = getDefaultFailResult();
}
}❓思考一下
活体检测可能有哪些异常情况?这些异常情况我们分别怎么处理?
暂无评论数据
发布
相关推荐
蓝亭书序
0
0
蓝亭书序
1
0
蓝亭书序
0
0
蓝亭书序
0
0
蓝亭书序
0
0
蓝亭书序
我还没有写个人简介......
帖子
提问
粉丝
鸿蒙UI开发——布局优先级
2026-11-18 14:32:08 发布鸿蒙UI开发——实现按比例布局
2026-11-18 14:30:54 发布



京公网安备:11010502051901号