# 开始使用 #### 动作活体检测视频采集要求 表1动作活体检测视频检测要求 | 活体检测动作 | 动作示例 | 视频动作说明 | |:---|:---|:---| | 左摇头 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342651113.png) | **√**，左摇头幅度正常。 | | 左摇头 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001290132046.png) | **×**，左摇头幅度过大，超出画面。 | | 右摇头 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342532129.png) | **√**，右摇头幅度正常。 | | 右摇头 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342732093.png) | **×**，右摇头幅度过大，超出画面。 | | 点头 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001290452542.png) | **√**，点头幅度正常 | | 点头 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001289973358.png) | **×**，点头幅度过大，超出画面。 | | 嘴部动作 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342652761.png) | **√**，正常张闭嘴动作。 | | 嘴部动作 | ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342652893.png) | **×**，嘴部均处于张开状态。 | | 视频采集注意事项： - 保证光线正常，不要出现背光、过亮或过暗等。 - 人脸需尽可能位于手机画面中央，不能太小或太大。 - 人脸尽可能与手机保持水平，避免过于仰视、俯视和侧视。 - 低头、左转或右转时，动作速度保持正常，不要过快或过慢，幅度不宜过大，整个动作过程中，人脸需要保证在手机画面中，不宜移出手机画面。 - 张嘴动作时，开始状态应处于合嘴状态，不宜处于张嘴或半张嘴状态。 - 整个动作期间，动作不宜太快和太慢，一个动作需在2\~5秒内完成。不要出现突然动作，如突然转头、突然张大嘴等。 ||| #### 通过华为云控制台使用 1. 登录API网关[控制台](https://console.huaweicloud.com/apig/)，选择"共享版"。 图1API网关共享版 ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001290135776.png "点击放大") 2. 单击左侧导航栏"开放API \> API管理"，选择已创建的API，并单击进入API网关页面。 图2进入API网关页面 ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342737125.png "点击放大") 3. 单击"调试"，进入API调试页面。 图3准备调试 ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342903133.png "点击放大") 4. 请求方法选择"GET"，参考表填写查询参数。 表2查询参数说明 | 参数名称 | 类型 | 是否必选 | 说明 | |:---|:---|:---|:---| | actions | String | 是 | 动作代码顺序列表，英文逗号(,)分隔。建议单动作,目前支持的动作有: 1:左摇头 2:右摇头 3:点头 4:嘴部动作（视频录制详见 [表1]）。 - 仅当actions的传参顺序和视频中的动作顺序一致时返回true。例如，视频中人物动作顺序为点头、嘴部动作，传参顺序需为3,4。 - 若上传视频动作顺序与填写动作顺序不一致时，活体检测服务校验失败，服务终止。 | | video_url | String | 是 | 视频的URL路径，目前仅支持华为云上OBS的URL。 视频上传至OBS和URL获取方法请参见[获取OBS中对象URL](https://support.huaweicloud.com/bestpractice-ivs/ivs_09_0010.html)。 - 视频要求：视频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 | 是 | 被验证人的身份证号码。 | 5. 单击"发起请求"，即可获取调试结果。 图4获取调试结果 ![](https://support.huaweicloud.com/bestpractice-ivs/zh-cn_image_0000001342943501.png "点击放大") 表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功能](https://support.huaweicloud.com/usermanual-apig/apig-ug-180307023.html)，将调试成功的解决方案，发布为API，基于该API进行二次开发，并对接到业务系统中。