HarmonyOS5 便捷生活类——使用活体检测API报错闪退（系列见主页）

加入下方官方班级，得鸿蒙礼盒

一起拿鸿蒙礼盒，戳我戳我！！

本期活动时间：2025年8月1日-12月31日

---

问题现象

运行官网人脸活体检测API中的demo实例，出现报错闪退，报错信息为：

message:Cannot read property startLivenessDetection of undefined。

背景知识

通过IDE运行官网demo时，需确定使用的工程机版本与IDE版本是否配套，如不配套需进行对应版本的升级处理。同时，需确定工程里build-profile.json5文件里products的内容中SDK版本是否兼容。

解决方案

版本升级及兼容性问题可以参考官网的版本说明。

工程里内容排查具体可以按照以下步骤处理：找到工程级build-profile.json5文件中的products，查看属性“compatibleSdkVersion”，目前API12才开始支持人脸活体检测功能，例如下列代码将最低兼容的SDK版本设为“5.0.0(12)”。

"products": [
{
"name": "default",
"signingConfig": "default",
"compatibleSdkVersion": "5.0.0(12)",
"runtimeOS": "HarmonyOS",
}
]

常见FAQ

Q:人脸活体检测SDK在nova14手机上检测失败。

A:建议线上用户尝试一下调亮屏幕亮度或换一个光线亮一点的环境，或者可以更新nova14至最新版本。