更新 'AI/安卓活体核身接入文档.md'

AI/安卓活体核身接入文档.md

@@ -11,13 +11,11 @@
 
 ### 配置证书和签名
 
-1. 提供 appid 和 签名文件md5码 获取证书文件（待补充）
+1. 提供 appid 和 签名文件md5码 获取3个证书文件（待补充），放入您的项目目录 `app\src\main\assets`
     * aip.license
     * idl-key.face-android
     * idl-license.face-android
-2. 配置文件：console_config.json
-3. 4个文件放入您的项目目录 `app\src\main\assets`
-4. app\build.gradle 内配置：
+2. app\build.gradle 内配置：
 
     ```
     android {
@@ -49,7 +47,7 @@
 
 ### 添加依赖
 
-为人脸核身 SDK 添加依赖的方式：将提供的 AAR 文件加入到 App 工程的 libs 文件夹下面，并且在 build.gradle 中添加下面的配置。
+为人脸核身 SDK 添加依赖的方式：将提供的 AAR 文件加入到 App 工程的 libs 文件夹内，并且在 build.gradle 中添加下面的配置。
 
 ```
 android{
@@ -95,13 +93,13 @@ SDK 需要用到以上权限，对 Android 6.0 以上的系统 SDK 会做权限
  - **Android 6.0 以下系统**
  -由于 Android 6.0 以下系统 Android 并没有运行时权限检测，建议调用方在拉起 SDK 前，对权限进行检测。-
 
-## 混淆配置
+
 
 <span id='shili'></span>
 
 # 接入示例
 
-视频核身：
+快速调用：
 ```
 # 在MainActivity中单击某个按钮的代码逻辑
 
@@ -111,6 +109,7 @@ cert.setPassword("xxxx");
 cert.setUserCode("xxxx");
 cert.setUrl("xxxx");
 cert.setSysName("xxxx");
+
 FaceidSDK.getInstance().init(MainActivity.this, cert,new FaceidSDK.FaceidLoginListener() {
     @Override
     public void onLoginSuccess() { //登录成功,拉起 SDK 页面
@@ -134,6 +133,7 @@ FaceidSDK.getInstance().init(MainActivity.this, cert,new FaceidSDK.FaceidLoginLi
     }
 });
 ```
+
 [完整demo下载](./demo/faceidsdkdemo.rar) (跳转后点击查看**原始文件**)
 
 # 接口详细说明
@@ -150,6 +150,15 @@ public class FaceidSDK {
     public static FaceidSDK getInstance(){
     //    ...
     }
+    
+    
+    /**
+    * 自定义动作参数，在init执行之前设置才有效
+    * 设置“人脸动作范围”，“从范围中随机选取几个动作”等参数
+    */
+    public void setFaceSDKConfig(FaceSDKConfig faceSDKConfig) {
+    //    ...
+    }
 
     /**
     * 在使用SDK前先初始化，
@@ -162,7 +171,7 @@ public class FaceidSDK {
 
     /**
     * 初始化成功后，调用此函数拉起sdk页面。
-    * 传入IDCardInputData（身份证，姓名，动作类型）
+    * 传入IDCardInputData（身份证，姓名）
     * 由FaceidResultListener返回人脸核身结果。
     */
     public void startActivity(IDCardInputData data,FaceidResultListener resultListener) {    
@@ -171,7 +180,7 @@ public class FaceidSDK {
     
     /**
     * 初始化成功后，调用此函数拉起sdk页面。
-    * 传入PhotoInputData（照片，动作类型）
+    * 传入PhotoInputData（照片）
     * 由FaceidResultListener返回人脸核身结果。
     */
     public void startActivity(PhotoInputData data,FaceidResultListener resultListener) {    
@@ -228,5 +237,30 @@ public class FaceidSDK {
 | --- | --- | --- | --- |
 | origin        | 文件类型<br/> base64形式：self<br/> 链接形式：uri  <br/> | DataItem.DataOrigin |  是       |
 | data | 照片内容（base64或uri链接）| String | 是 | 
+
+
+<span id='zidingyi'></span>
+## 动作参数说明
+
+| FaceSDKConfig参数 | 说明 | 类型 |
+| --- | --- | --- |
+| actions | 动作范围<br/> 可选"eye","mouth","headRight","headLeft","headUp","headDown","yaw"<br/>默认包含所有| List\<String\> | 
+| actionOrderRandom | 动作顺序随机 | boolean | 
+| actionNum | 随机从actions中选取几个动作，默认3 | int | 
+
+
+## 动作
+
+| 参数名 | 说明 |
+| --- | --- |
+| eye | 眨眼 |
+| mouth | 张嘴 |
+| headRight | 头右转 |
+| headLeft | 头左转 |
+| headUp | 抬头 |
+| headDown | 点头 |
+| yaw | 摇头 |
+
+
 # 错误码
 > 非0为未通过