key-value 说明

在声网 SDK 提供的插件相关方法和回调中，key 和 value 参数取决于你使用的插件。本页提供远鉴人脸活体检测插件支持的 key 和 value 说明。

插件的 key 概览

方法 key

调用声网 SDK 的 setExtensionPropertyWithVendor 方法时，支持传入以下 key：

setExtensionPropertyWithVendor 方法的 key	描述
set_appKey_appSecret	设置 appKey 和 appSecret。
retry	重试。

回调 key

声网 SDK 的 onEvent 回调可能包括以下 key：

onEvent 回调的 key	描述
result	当前识别结果

方法 key 的 value 说明

set_appKey_appSecret

value 包含以下参数：

value 参数	描述
appKey	NSString 类型，使用远鉴活体检测的 appKey。
appSecret	NSString 类型，使用远鉴活体检测的订阅密钥。

retry

value 包含以下参数：

value 参数	描述
retry	BOOL 类型，固定传 @1 即可。

回调 key 的 value 说明

result

value 包含以下参数：

value 参数	描述
errorCode	NSString 类型，错误码。
message	NSString 类型，错误信息。

错误码

错误码	说明	解决方法
0	校验为活体	/
1001	检测超时	可以重新校验，调用 retry，或者停止检测
1002	打开引擎库失败	返回上一个页面，重新进入检测页面
1003	引擎库返回人脸图片为空	重新检测，调用 retry
1004	setExtensionPropertyWithVendor 方法参数格式错误	setExtensionPropertyWithVendor 方法的 value 参数是否为 JSON 格式的字符串
1005	appKey 为空	set_appKey_appSecret 传入的 appKey 是否为空
1006	appSecret 为空	set_appKey_appSecret 传入的 appSecret 是否为空
2000	人脸图像采集成功	/
2001	未识别到人脸信息	/
2002	脸部位置不合法	/
2003	脸部面积太小	/
2004	脸部面积太大	/
2005	光线太暗	/
2006	光线太亮	/
2007	清晰度太低	/
2008	手机需要竖屏	/
3001	网络请求出错	检查网络，重新检测，调用 retry
3002	检测失败	根据 onEvent 方法返回的具体提示做处理