目录

Android


产品介绍/快速入门

远程视频面签需要PC端坐席的支持,手机端APP作为用户端,发起视频面签,远程坐席点击接通相关呼叫,即可创建音视频房间进行面签业务处理,此种方式面签需要PC端H5SDK以坐席的身份进行接通呼叫。

实现的相关功能点如下:

√ 音视频通话

√ 云端录制

√ 活体人脸核身

√  拍照留存

开发手册

1. 请联系相关人员开通租户权限,获取【企业账号】。

2. 在【签里眼视频面签SaaS管理系统】对队列进行新增管理,拿到队列编号。

3. (按需提供)发起人脸识别需要姓名、证件号、大头照的base64(可有可无)。如果业务系统已经有了人脸识别需要提供人脸识别的结果和大头照的base64。

 

接口开发手册

3.1 build.gradle配置

 

app目录下的build.gradle文件中android块中配置相关的sourceSets标签,如果没有使用该标签则新增,代码如下

sourceSets {
    main {
        jniLibs.srcDirs = ['libs']
    }
}

dependencies {
    implementation files('libs\\newlibrary-release.aar')
    implementation files('libs\\libspinner.aar')
    implementation files('libs\\loadLibrary.aar')
    implementation 'androidx.multidex:multidex:2.0.1'
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'com.qianwen:okhttp-utils:3.8.0'
    implementation 'com.squareup.okhttp3:okhttp:4.0.1'
    implementation 'com.squareup.okhttp3:logging-interceptor:3.4.0-RC1'
    implementation 'com.squareup.retrofit2:retrofit:2.0.2'
    implementation 'com.squareup.retrofit2:adapter-rxjava:2.0.2'
    implementation 'com.squareup.retrofit2:converter-gson:2.0.2'
    implementation 'io.reactivex:rxandroid:1.1.0'
    implementation 'io.reactivex:rxjava:1.1.3'
    implementation 'androidx.recyclerview:recyclerview:1.1.0'
    implementation 'com.github.yalantis:ucrop:2.2.4'
    implementation 'com.google.android.material:material:1.0.0-rc01'
    implementation 'com.github.vondear:RxTools:v1.7.8.1'
    implementation 'com.tbruyelle.rxpermissions:rxpermissions:0.9.4@aar'
    implementation 'org.greenrobot:greendao:3.2.2'
    implementation 'com.qianwen:update-app:3.5.2'
    implementation files('libs\\WbCloudFaceReflectLiveSdk-v2.1.91-09c9fe1.aar')
    implementation files('libs\\WbCloudNormal-v4.0.0-9267e3d.aar')
}

 

如果android.V4 冲突,请删除本项目V4的引用,升级为androidX对应的引用更换

implementation 'androidx.appcompat:appcompat:1.1.0'

 

3.2 权限声明

添加权限声明AndroidManifest.xml文件

<!-- 为了能使用OpenGLES 2.0 API,你必须在你的manifest中添加以下声明: -->
<uses-feature android:glEsVersion="0x00020000" android:required="true" />
<!-- 如果你的应用要使用纹理压缩功能,你必须还要声明设备需要支持什么样的压缩格式 -->
<supports-gl-texture android:name="GL_OES_compressed_ETC1_RGB8_texture" />
<supports-gl-texture android:name="GL_OES_compressed_paletted_texture" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.RECORD_VIDEO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

 

3.2.1开发环境中设置的compileSdkVersion高于23(Android6.0)时以上时,请注意添加相机,录音和内部存储空间的动态权限 

Manifest.permission.CAMERA
Manifest.permission.RECORD_AUDIO
Manifest.permission.WRITE_EXTERNAL_STORAGE
Manifest.permission.READ_PHONE_STATE

3.2.2 检查是否开启动态权限

· /**
 * 查看是否权限 返回值为true代表权限已经全部开启
 */
public boolean checkPermission(String... permissions) {
   //如果android版本低于Android6.0,默认为开启权限(无危险权限)
   if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) return true;
   PackageManager pm = contextWeakReference.get().getPackageManager();
   for(String permission : permissions) {
      if (PackageManager.PERMISSION_GRANTED !=
            pm.checkPermission(permission, contextWeakReference.get().getPackageName())) {
         return false;
      }
   }
   return true;
}

3.2.3 添加缺省的动态权限

         · /**
 * 获取需要申请权限的列表
 */
private List<String> findDeniedPermissions(String[] permissions) {
   List<String> needRequestPermissionList = new ArrayList<>();
   for (String perm : permissions) {
      if (ContextCompat.checkSelfPermission(contextWeakReference.get(), perm) != PackageManager.PERMISSION_GRANTED) {
         needRequestPermissionList.add(perm);
      } else {
         if (ActivityCompat.shouldShowRequestPermissionRationale(
               activityWeakReference.get(), perm)) {
            needRequestPermissionList.add(perm);
         }
      }
   }
   return needRequestPermissionList;
}

3.3 集成sdk Library

 

sdk library集成到 本SDK 依赖到项目

libs文件夹中的arr包,放置项目libs文件夹下

 

3.4 定义项目配置清单

 

需要在本项目的AndroidManifest.xml 文件中加入provider 标签,并且修改标签authorities 属性为自己项目的包名即可如下标注位置


<provider

            android:name="androidx.core.content.FileProvider"

            tools:replace="android:authorities"

            android:authorities="com.bufeng.videoSDK"

            android:exported="false"

            android:grantUriPermissions="true">

            <meta-data

                android:name="android.support.FILE_PROVIDER_PATHS"

                android:resource="@xml/file_paths" />

        </provider>

需要注意 

远程面签需要 合作方 通过API 获取 队列信息。然后发起面签。

自主面签面签结束后,如果没有网络或不想上传的情况下,可以点击退出系统,然后合作方保存本次未上传视频的名称和相关信息,然后下次直接调用上传的接口。




3.5 初始化sdk

项目中自定义Application需继承SDK中的PureApplication对象,并且重写attachBaseContext方法 ,方法如下。

@Override

protected void attachBaseContext(Context base) {

    super.attachBaseContext(base);

    MultiDex.install(base);

}


3.5.1 登录SDK

调起SDK方法PureVersionSDK类中的doLoginSDK方法,参数如下:

/**

     * 登录SDK

     * @param context         上下文

     * @param accountId       企业账号

     * @param business_id     业务ID

     * @param assist_id       辅助ID

     * @param companyName     公司名称

     * @param doLoginCallBack 登录回调接口

     */


其中 DoLoginCallBack 登录回调接口格式如下:

public interface DoLoginCallBack {

       void onSuccess(DoLoginResult doLoginResult);

       void onFail(String message);

}


onSuccess方法中启动面签服务

3.5.2 启动面签

调起SDK方法PureVersionSDK类中的startInterview方法,参数如下:

/**

     *

     * @param activity 当前activity实例

     * @param interviewInformation 面签实体类

     * @param onExitVideoCallBack   退出面签回调

     */


 

3.6 User 活体核身实体类

//是否使用人脸识别

   private boolean useFaceIdentification = false;

   

//使用人脸识别必填参数


//人员名称

private String name = "";

//证件号

private String idNumber = "";

//人脸识别失败是否继续业务流程

private boolean nextFail = false;  

//是否使用默认人脸对比源

private boolean useDefaultFaceImg = false;

//默认人脸比对源(useDefaultFaceImg true必填,false选填)

private String defaultComparisonSource ;

 

//不使用人脸识别必填参数(自定义设置识别结果)


//人脸识别结果 1成功 2失败 3未识别

private int faceResult = 1;    

//人脸对比相似度(0.0—100.0

private String similarity = "0.0";



3.7活体人脸核身

请联系合作方配置活体人脸核身相关参数后调用

/**

     * 人脸识别

     *

     * @param businessId 业务ID

     * @param userList   人脸识别用户集合

     * @param userIndex  当前要进行人脸核身用户索引

     */

    private void startFace(String businessId, List userList, int userIndex,) {

        PureVersionSDK.getInstance().startFaceIdentification(MainActivity.this, businessId, userList, userIndex, new FaceResultCallback() {

            @Override

            public void onFaceResultSuccess() {

              //人脸识别成功

            }


            @Override

            public void onFaceResultFailed(String result) {

//人脸识别失败

            }


            @Override

            public void onStartFaceResultActivity(int index,

List userInfoList) {

              //继续识别或者启动面签服务  

startInterView(index, userInfoList

             

            }

        });

    }

3.8 视频面签类型及传递参数

 

 3.8.1 //远程面签类型

      private int faceType = FaceType.INTERVIEW_TYPE_REMOTE;

      //用户昵称(唯一必填)  

      private String nickName;

      //队列编号 (必填)

      private String queueId;

      //合同文件(选填)

      private String signatureUrl;

      //活体人脸检测集合(可自定义)

      private List userInfoList;

PureApplication.getInstance().setFaceComparePicture(compareSourcePicture);

//活体人脸检测集合(可自定义)

private List userInfoList;


版本更新日志

2023.08.21

本地录制横竖屏模式适配

照片水印横竖屏模式适配

2023.04.06

远程面签增加横竖屏切换功能

照片水印横竖屏模式适配

2022.10.06

增加合同查看/合同签名屏幕共享功能

2022.09.02

优化Intent传递图片数据崩溃问题

优化地理位置信息解析逻辑

2022.08.08

优化视频水印功能

2022.04.19

优化人脸比对功能

人脸出框相似度修改为后台控制

2022.01.15

优化活体人脸核身功能

增加活体人脸核身错误码/错误信息回调

2021.11.27

新增地理位置上报功能

2021.10.22

优化远程协助客户端部分机型无法响应座席端点击事件问题

2021.8.13

新增远程协助用户端/座席端模式

2021.05.11

优化视频播放功能,提高视频播放速度

优化部分机型无法调起原生相机拍照功能

2021.1.11

远程面签及无人工面签 添加查看照片功能,删除照片功能

remotelyRiskVoideUrl 传入本地视频地址

无人工面签title文案修改

修改文件夹路径可查看

修改安卓分辨率

本地风险视频地址 copyAssetAndWrite方法实现

2020-12-25

选择面签模式排序

修复远程转自助时没有声音的bug

2020-12-03

public void exitVideoCallBack(String latitudeLongitude ,String locationInformation) {}

新增 : latitudeLongitude ;locationInformation; 经纬度 ;地理位置信息

2020-11-24

requestpersonInfo方法

新增远程面签风险视频地址仅支持https并且与坐席端同域

新增水印公司名称必传

新增功能: 拍照水印; 无人工坐席面签; 网络检测转自助