更新记录

1.3.3（2024-09-09）

优化修改人脸数据后注册不生效问题

1.3.2（2024-06-17）

添加手动筒功能，添加自定义预览角度和检测角度功能

1.3.0（2024-04-10）

1. 添加设备硬件指纹获取
2. 添加删除所有人脸库数据
3. 优化后置摄像头无法识别的问题

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

Mu-BDFaceSDK

引入

const muBDFaceSDK = uni.requireNativePlugin('Mu-BDFaceSDK');

获取设备硬件指纹

let deviceId = muBDFaceSDK.getDeviceId();
console.log("设备硬件指纹：" + deviceId)

授权激活以及初始化模型文件

muBDFaceSDK.init({
    mode: 3, // 1联网激活，2离线激活，3批量激活(默认)
    licenseId: '授权ID', // mode=1,3时必须
    loadModelFlag: true // 是否加载模型
}, res => {
    console.log("初始化结果：" + JSON.stringify(res))
});

初始化模型文件

muBDFaceSDK.loadModel(res => {
    console.log("加载模型结果：" + JSON.stringify(res))
});

是否开启手电筒

muBDFaceSDK.setFlashLightFlag(boolean flashLightFlag);

人像翻转（true翻转，false不翻转）

muBDFaceSDK.setRgbRevert(boolean rgbRevert);

自定义预览角度（值域：0/90/180/270）

muBDFaceSDK.setRgbVideoDirectionCustom(int rgbVideoDirectionCustom);

自定义检测角度（值域：0/90/180/270）

muBDFaceSDK.setRgbDetectDirectionCustom(int rgbDetectDirectionCustom);

人脸注册（特征点：通过人脸识别特征点同步接口获取的特征点，接口版本参数version为Android_8001）

muBDFaceSDK.register({
    userId: '用户主健，必填且只能是英文和数字的组合',
    userInfo: '用户信息，可以为JSON字符串或者String',
    imageType: 0, // 图片类型（0 Base64字符串, 1 图片本地路径, 2 人脸特征点）
    image: '图片资源，根据imageType传',
    isPush: false // 是否刷新人脸库，默认false不刷新
}, res => {
    console.log("注册结果：" + JSON.stringify(res))
});

刷新人脸库

muBDFaceSDK.refreshFaceDatabases();

开启人脸识别（悬浮框

muBDFaceSDK.startFaceDetect({
    width: 640, // 预览宽度，默认-1（全屏）
    height: 480, // 预览高度，默认-1（全屏）
    offsetX: 0, // 预览框X轴偏移量，默认0
    offsetY: 0, // 预览框Y轴偏移量，默认0
    needDetectImage: false, // 是否返回检测图片，默认false
    quality: 50, // 检测图片质量，默认50
    interval: 5, // 检测间隔时间（单位秒，默认5秒
    cameraId: 1 // 相机（默认1）
}, res => {
    console.log("识别结果：" + JSON.stringify(res))
});

关闭人脸识别/采集

muBDFaceSDK.stopFaceDetect();

开启人脸采集（悬浮框

muBDFaceSDK.startFaceCollect({
    width: 640, // 预览宽度，默认-1（全屏）
    height: 480, // 预览高度，默认-1（全屏）
    offsetX: 0, // 预览框X轴偏移量，默认0
    offsetY: 0, // 预览框Y轴偏移量，默认0
    quality: 50, // 检测图片质量，默认50
    cameraId: 1 // 相机（默认1）
}, res => {
    console.log("采集结果：" + JSON.stringify(res))
});

打开人脸识别界面

muBDFaceSDK.openFaceDetect(res => {
    console.log("识别结果：" + JSON.stringify(res))
}, {
    cameraId: 1, // 相机（默认1）
    timeout: 0 // 大于0开启计时，计时结束关闭；否则不计时
});

打开人脸采集界面

muBDFaceSDK.openFaceCollect(res => {
    console.log("识别结果：" + JSON.stringify(res))
}, {
    cameraId: 1, // 相机（默认1）
    timeout: 0, // 大于0开启计时，计时结束关闭；否则不计时
    debug: false // 调试模式，true标识开启
});

插件指定用户

muBDFaceSDK.getUser(userId, res => {
    console.log("用户数据：" + JSON.stringify(res))
});

查询人脸库数据

muBDFaceSDK.getUserList(res => {
    console.log('人脸列表：' + JSON.stringify(res.data))
});

删除人脸库中的用户

let success = muBDFaceSDK.deleteUser(userId);
console.log(success ? '删除用户成功' : '删除用户失败')

删除人脸库的所有数据

let success = muBDFaceSDK.deleteAll();
console.log(success ? '删除成功' : '删除失败')