更新记录

1.3.0(2024-04-10)

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

1.2.0(2023-09-07)

  1. 添加用户ID插件用户信息;2. 解决返回的特征点Base64和人脸Base64字符串结尾有\n的问题;3. 优化人脸注册,添加是否刷新人脸库内存的字段,避免注册慢的问题

1.1.4(2023-09-01)

添加人脸识别和人脸采集超时关闭功能

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 12.0 armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 ×

原生插件通用使用流程:

  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))
});

人脸注册(特征点:通过人脸识别特征点同步接口获取的特征点,接口版本参数version为Android_8001)

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

开启人脸识别(悬浮框

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开启计时,计时结束关闭;否则不计时
});

插件指定用户

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 ? '删除成功' : '删除失败')

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.WRITE_SETTINGS" /> <uses-permission android:name="android.permission.GET_TASKS" /> <uses-permission android:name="android.permission.VIBRATE" /> <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.hardware.camera.autofocus" /> <uses-feature android:name="android.hardware.camera" /> <uses-feature android:name="android.hardware.camera.autofocus" /> <uses-feature android:name="android.hardware.camera.front" /> <uses-feature android:name="android.hardware.camera.front.autofocus" />

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件自身不采集任何数据,插件使用的是百度人脸离线识别SDK会采集数据,详情可参考:https://ai.baidu.com/ai-doc/FACE/Yk37c1opz

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问