开始使用
动作活体检测视频采集要求
活体检测动作 |
动作示例 |
视频动作说明 |
|---|---|---|
左摇头 |
|
√，左摇头幅度正常。 |
|
×，左摇头幅度过大，超出画面。 |
|
右摇头 |
|
√，右摇头幅度正常。 |
|
×，右摇头幅度过大，超出画面。 |
|
点头 |
|
√，点头幅度正常 |
|
×，点头幅度过大，超出画面。 |
|
嘴部动作 |
|
√，正常张闭嘴动作。 |
|
×，嘴部均处于张开状态。 |
|
视频采集注意事项：
|
||
通过华为云控制台使用
- 登录API网关控制台，选择“共享版”。
图1 API网关共享版
- 单击左侧导航栏“开放API > API管理”，选择已创建的API，并单击进入API网关页面。
图2 进入API网关页面
- 单击“调试”，进入API调试页面。
图3 准备调试
- 请求方法选择“GET”，参考表填写查询参数。
表2 查询参数说明 参数名称
类型
是否必选
说明
actions
String
是
动作代码顺序列表，英文逗号(,)分隔。建议单动作,目前支持的动作有: 1:左摇头 2:右摇头 3:点头 4:嘴部动作（视频录制详见 表1）。
- 仅当actions的传参顺序和视频中的动作顺序一致时返回true。例如，视频中人物动作顺序为点头、嘴部动作，传参顺序需为3,4。
- 若上传视频动作顺序与填写动作顺序不一致时，活体检测服务校验失败，服务终止。
video_url
String
是
视频的URL路径，目前仅支持华为云上OBS的URL。
视频上传至OBS和URL获取方法请参见获取OBS中对象URL。
- 视频要求：视频Base64编码后大小不超过8MB。 限制视频时长1~15秒。
- 建议帧率：10fps~30fps。
- 封装格式：mp4、avi、flv、webm、asf、mov。 视频编码格式: h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。
verification_name
String
是
被验证人的姓名。
verification_id
String
是
被验证人的身份证号码。
- 单击“发起请求”，即可获取调试结果。
图4 获取调试结果
表3 调试结果说明 调试结果
说明
[{'meta': {'uuid': '2022-05-16T09:57:00.539597'}, 'result': {'service_name': 'ivs-standard', 'count': 1, 'resp_data': [{'verification_result': 'valid',...
表示识别成功。
Failed to invoke the FRS service
活体检测服务调用失败，需检查“video_url”视频路径和“actions”动作参数是否输入正确。
living body verification failed
活体检测服务校验未通过，服务终止。
Failed to invoke the IVS service
人证核身服务调用失败，需检查“verification_name”姓名和“verification_id”身份证号参数是否输入正确。
Failed to verify the certificate of the applicant
活体检测服务校验未通过，服务终止。
video_url or actions not obtained
“video_url ”视频的URL路径，或者 “actions ”动作代码顺序列表，未传参。
verification_name or verification_id not obtained
“verification_name ”被验证人的姓名，或者“verification_id ”被验证人的身份证号码，未传参。
通过API使用
用户可以通过API网关服务提供的发布API功能，将调试成功的解决方案，发布为API，基于该API进行二次开发，并对接到业务系统中。
