远程视频面签需要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>
需要注意
l 远程面签需要 合作方 通过API 获取 队列信息。然后发起面签。
l 自主面签面签结束后，如果没有网络或不想上传的情况下，可以点击退出系统，然后合作方保存本次未上传视频的名称和相关信息，然后下次直接调用上传的接口。
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并且与坐席端同域；
新增水印公司名称必传；
新增功能: 拍照水印; 无人工坐席面签; 网络检测转自助
