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

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

@@ -4,9 +4,45 @@
 
 ### 注意事项
 
-- 人脸核身 SDK（Faceid）最低支持到 支持 Android 4.0 以上版本 API LEVEL 16。
-- 人脸核身 SDK 将以 AAR 文件的形式提供，即 faceidsdk.aar。
-- 人脸核身 SDK 同时需要依赖**公共组件（cepm_common.aar）**，同样也是以 AAR 文件的形式提供，详情请参见 [添加依赖](#yilai)。
+- 人脸核身 SDK（Faceid）最低支持到 支持 Android 4.0 以上版本 API LEVEL 16，armeabi-v7a。
+- 人脸核身 SDK 将以 AAR 文件的形式提供，即 faceid-release.aar 和 faceplatform-release.aar。
+- 人脸核身 SDK 同时需要依赖**公共组件（common-release.aar）**，同样也是以 AAR 文件的形式提供，详情请参见 [添加依赖](#yilai)。
+
+
+### 配置证书和签名
+
+1. 提供 appid 和 签名文件md5码 获取证书文件（待补充）
+    * aip.license
+    * idl-key.face-android
+    * idl-license.face-android
+2. 配置文件：console_config.json
+3. 4个文件放入您的项目目录 `app\src\main\assets`
+4. app\build.gradle 内配置：
+
+    ```
+    android {
+        ...
+        signingConfigs {
+            debug {
+                storeFile file('xxxx.jks')//申请证书时的签名文件
+                storePassword 'xxxx'
+                keyAlias = 'xxxx'
+                keyPassword 'xxxx'
+            }
+        }
+        ...
+        defaultConfig {
+        ...
+        ndk {
+                abiFilters  "armeabi-v7a"//sdk仅支持，大于这个范围运行，会报找不到xxx.so文件
+            }
+        ...
+        }
+    }
+
+    ```
+  
+### 
 
 
 <span id='yilai'></span>
@@ -31,10 +67,11 @@ dependencies {
     implementation 'com.alibaba:fastjson:1.2.73'
     // okHttp依赖
     implementation 'com.squareup.okhttp3:okhttp:4.0.0'
-    // 公共aar
-    implementation(name: 'cepm_common', ext: 'aar')
-    // 活体核身
-    implementation(name: 'faceidsdk', ext: 'aar')
+    // common-release.aar
+    implementation(name: 'common-release', ext: 'aar')
+    // 人脸核身
+    implementation(name: 'faceid-release', ext: 'aar')
+    implementation(name: 'faceplatform-release', ext: 'aar')
 }
 
 ```
@@ -42,14 +79,21 @@ dependencies {
 
 在AndroidManifest.xml中添加
 ```
-<uses-permission android:name="android.permission.INTERNET" />
-<uses-permission android:name="android.permission.CAMERA" />
-<uses-permission android:name="android.permission.RECORD_AUDIO"/>
+    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
+    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
+    <uses-permission android:name="android.permission.CAMERA"/>
+    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
+    <uses-permission android:name="android.hardware.camera.autofocus"/>
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="android.permission.WRITE_SETTINGS" tools:ignore="ProtectedPermissions" />
+        
 ```
  - **Android 6.0 以上系统**
-SDK 需要用到网络/相机/录音权限，对 Android 6.0 以上的系统 SDK 会做权限的运行时检测。
+SDK 需要用到以上权限，对 Android 6.0 以上的系统 SDK 会做权限的运行时检测。
  - **Android 6.0 以下系统**
- 由于 Android 6.0 以下系统 Android 并没有运行时权限检测，建议调用方在拉起 SDK 前，对网络/相机/麦克风检测。
+ -由于 Android 6.0 以下系统 Android 并没有运行时权限检测，建议调用方在拉起 SDK 前，对权限进行检测。-
 
 ## 混淆配置
 
@@ -61,29 +105,31 @@ SDK 需要用到网络/相机/录音权限，对 Android 6.0 以上的系统 SDK
 ```
 # 在MainActivity中单击某个按钮的代码逻辑
 
-FaceidSDK.IDCardInputData inputdata=FaceidSDK.getInstance().new IDCardInputData(name.getText().toString(),idNum.getText().toString(), videoType);
-Credential credential = new Credential();
-credential.setSysName("XXXX").setPassword("XXXX").setUserCode("XXXX").setUrl("https://cepmtest.dhcccloud.com.cn/gateway");
-
-FaceidSDK.getInstance().init(MainActivity.this, credential,new FaceidSDK.FaceidLoginListener() {
+Credential cert=new Credential();
+final FaceidSDK.IDCardInputData inputdata=FaceidSDK.getInstance().new IDCardInputData("xxx","xxx");
+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 页面
-        FaceidSDK.getInstance().startActivity(MainActivity.this,inputdata, new FaceidSDK.FaceidResultListener() {
+        FaceidSDK.getInstance().startActivity(inputdata, new FaceidSDK.FaceidResultListener() {
             @Override
             public void onFailed(String errorCode, String errorMsg) {
-                txtresult.setText("失败：错误码"+errorCode+";错误信息"+errorMsg);
+                //txtresult.setText("失败：错误码"+errorCode+";错误信息"+errorMsg);
             }
 
             @Override
             public void onFinish(FaceidSDK.OutputData result) {
-                txtresult.setText("操作完成：识别结果"+result.isSuccess()+";相似分数"+result.getScore());
+                //txtresult.setText("操作完成：识别结果"+result.isSuccess()+";相似分数"+result.getScore());
 
             }
         });
     }
 
     @Override
-    public void onLoginFailed(String errorCode, String errorMsg) {
+    public void onLoginFailed(String s, String s1) {
 
     }
 });
@@ -119,7 +165,7 @@ public class FaceidSDK {
     * 传入IDCardInputData（身份证，姓名，动作类型）
     * 由FaceidResultListener返回人脸核身结果。
     */
-    public void startActivity(Context context,  IDCardInputData data,FaceidResultListener resultListener) {    
+    public void startActivity(IDCardInputData data,FaceidResultListener resultListener) {    
         // ...
     }
     
@@ -128,7 +174,7 @@ public class FaceidSDK {
     * 传入PhotoInputData（照片，动作类型）
     * 由FaceidResultListener返回人脸核身结果。
     */
-    public void startActivity(Context context,  PhotoInputData data,FaceidResultListener resultListener) {    
+    public void startActivity(PhotoInputData data,FaceidResultListener resultListener) {    
         // ...
     }
 
@@ -149,12 +195,12 @@ public class FaceidSDK {
     }
 ```
 
-`startActivity()` 的第二个参数PhotoInputData和IDCardInputData用来传递数据：
+`startActivity()` 的参数PhotoInputData和IDCardInputData用来传递数据：
 
  ```
     String name; //姓名
     String idNum; //身份证
-    FaceidSDK.VideoType videoType;//LIP数字模式，ACTION动作模式， SILENT静默模式
+    ----
     DataItem photo;//照片信息
  ```
 
@@ -171,17 +217,16 @@ public class FaceidSDK {
 | --- | --- | --- | --- | --- |
 | name | 核验人的姓名| String | - | 是 | 
 | idNum | 核验人的身份证号 | String | 32 | 是 |
-| videoType        | 人脸核身类型<br/>动作活体：FaceidSDK.VideoType.ACTION<br/>数字活体：FaceidSDK.VideoType.LIP<br/>静默活体：FaceidSDK.VideoType.SILENT | FaceidSDK.VideoType | -                  | 是       |
+
 
 | PhotoInputData参数 | 说明 | 类型 | 长度（字节） | 是否必填 |
 | --- | --- | --- | --- | --- |
 | photo | 核验人的照片，DataItem属性见下表| DataItem | - | 是 | 
-| videoType        | 人脸核身类型<br/>动作活体：FaceidSDK.VideoType.ACTION<br/>数字活体：FaceidSDK.VideoType.LIP<br/>静默活体：FaceidSDK.VideoType.SILENT | FaceidSDK.VideoType | - | 是       |
 
 
 | DataItem属性 | 说明 | 类型  | 是否必填 |
 | --- | --- | --- | --- |
-| origin        | 文件类型<br/> base64传输：self<br/>来自文件服务器：fds （**带压缩效果，推荐使用，详见[fds使用文档](../file/文件服务器接口.md)）**<br/>链接：uri    | DataItem.DataOrigin |  是       |
-| data | 照片内容（base64，文件服务器文件名或uri链接）| String | 是 | 
+| origin        | 文件类型<br/> base64形式：self<br/> 链接形式：uri  <br/> | DataItem.DataOrigin |  是       |
+| data | 照片内容（base64或uri链接）| String | 是 | 
 # 错误码
 > 非0为未通过