更新记录

1.0.18(2024-06-24)

替换sdk内核

1.0.17(2023-08-07)

替换识别内核

1.0.16(2022-08-08)

更新虹软SDK为V3.0

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 14

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


前言

虹软(免费版)人脸识别组件,支持活体识别、离线识别、图片人脸特征识别、图片是否同一人对比、相机人脸识别或对比,虹软收费版请使用https://ext.dcloud.net.cn/plugin?id=5785 新版本已经迁移到https://ext.dcloud.net.cn/plugin?id=11612

功能

  • 支持活体识别、离线识别
  • 图片人脸特征识别(年龄、性别、3DAngle)
  • 两张图片是否是同一人对比
  • 相机活体识别出人脸,用于人脸注册保存到本地,便于后面身份鉴定时作对比
  • 相机活体人脸对比,用于鉴定身份,常用于支付前活体人脸身份鉴定

激活引擎

使用之前需要激活引擎,虹软官方https://ai.arcsoft.com.cn/ucenter/resource/build/index.html#/login注册账号,获取appid、sdkkey,虹软免费版暂不支持高版本的android{好像是Android10以后就不支持免费版了}、iOS系统,激活时报错(错误码:28677),高版本的系统请使用虹软增值收费版请使用https://ext.dcloud.net.cn/plugin?id=5785 激活错误码查询:https://ai.arcsoft.com.cn/ucenter/resource/build/index.html#/help

如果是老用户,一年时期到了不能识别,请登陆虹软开发者中心重新添加SDK,生成新的SDK_KEY,使用新的SDK_KEY,然后重新自定义基座打包


var arcface = uni.requireNativePlugin("wrs-arcfacefree");
var options = {};
options.appid = "xxxxx";
switch (uni.getSystemInfoSync().platform) {
    case 'android':
        options.sdkkey = 'xxx';
        break;
    case 'ios':
        options.sdkkey = 'xxx';
        break;
    default:
        break;
}
arcface.activeEngine(options, (resp) => {
    if (resp.result) {
        console.log("激活成功");
    } else {
        console.log("激活失败");
    }
    this.showMsg("引擎激活结果:" + JSON.stringify(resp))
});

获取图片人脸信息(年龄、性别、3DAngle)


var options = {
                    url: “” // 本地图片地址或网络图片
                };
arcface.getImageFaceFeature(options, (resp) => {
    if (resp.result) {
        console.log("识别成功");
    } else {
        console.log("识别失败");
    }
    this.showMsg("图片识别结果:" + JSON.stringify(resp))
});

设置相机检测角度

如果识别不到人脸(一般手机app开发都不用设置,某些Android嵌入式摄像头需要设置),可以尝试调整这个参数,取值为[0, 90, 180, 270, all],类型为字符串,分表表示检测0度、90度、180度、270度、全方位角度


arcface.setVideoAngle({
   videoAngle: "all" // 0:仅检测0度 90:仅检测90度  180:仅检测180度  270:仅检测270度 all:检测0、90、270、180全角度
});

判断2个人脸图是否是同一个人


var options = {
    url1: “”, // 图片1地址,本地图片地址或网络图片
    url2: ”“ // 图片2地址 
};
arcface.getSimilarity(options, (resp) => {
    if (resp.result) {
        var similarity = resp.similarity;
        if (similarity >= 0.80) { // 一般相似度大于0.8基本上就是同一个人了
            console.log("是同一个人");
        } else {
            console.log("不是同一个人");
        }
    }
    this.showMsg("获取相似度结果:" + JSON.stringify(resp))
});

判断权限


                switch (uni.getSystemInfoSync().platform) {
                    case 'android':
                        arcface.checkPermission((resp) => {
                            this.showMsg("授权结果:" + JSON.stringify(resp));
                        });
                        break;
                    case 'ios':
                        arcface.checkVideoPermission((resp) => {
                            this.showMsg("授权结果:" + JSON.stringify(resp));
                        });
                        break;
                }

摄像机人脸识别或人脸身份对比鉴定


<wrs-arcfacevideofree ref='arcfacevideo' :style="'width:'+width+'px;height:'+height+'px;'" :config="config" @resultCallback="resultCallback">

</wrs-arcfacevideofree>
                config: {
                    bgColor: "#000000", // 背景颜色
                    anchorFrame: {
                        bgImage: frameImage, // 人脸框图片
                        left: left, // 人脸框左边距,单位 dp
                        top: top, // 人脸框上边距
                        width: frameWidth,// 人脸框宽度
                        height: frameHeight // 人脸框高度
                    }
                }

config属性:

  • bgColor: 背景颜色
  • anchorFrame: 人脸框
  • anchorFrame.bgImage: 人脸框图片
  • anchorFrame.left: 人脸框左边距,单位 dp
  • anchorFrame.top:人脸框上边距
  • anchorFrame.width: 人脸框宽度
  • anchorFrame.height: 人脸框高度

方法: 停止摄像头

this.$refs.arcfacevideo.stop();

开始摄像头,组件默认已经开启摄像头


this.$refs.arcfacevideo.start();

开始识别人脸,需要在组件事件onLoadView中或之后调用


var params = {};
 var params = {
    mode: "compare", // 模式,支持recognize、compare,recognize表示从摄像头识别人脸,一般用于人脸注册保存到本地,compare表示从摄像头识别出某个人,一般用于身份鉴权
    compareImage: {
        type: 'url', //  类型,支持url、base64、faceFeatureData,url表示图片地址,支持本地地址,base64表示图片base64的字符串,faceFeatureData表示人脸特征数据的字符串
        value: saveImageFilePath,
        name: "张三"
    }, // 比较图片地址
    similarity: 0.8, // 相似度,大于这个相似度表示是同一个人
    liveness: false, // 是否活体识别
    faceNeedInRect: false, // 人脸是否需要在anchorFrame人脸框内
    needBase64Image: false, // 识别到的图片是否需要进行base64编码返回,base64编码在Android上比较慢
    needFaceFeatureData: false, // 是否需要人脸特征base64后返回
    cropAnchorFrameImage: false,   // 返回的base图片或保存saveImageFilePath的图片是否只需要裁剪人脸大小
    cropAnchorFrameImageBestRect: false // 为了美观,裁剪人脸大小是否扩大人脸图,仅对Android生效

 };
this.$refs.arcfacevideo.startFace(params);

params参数:

  • mode: 模式,支持recognize、compare,recognize表示从摄像头识别人脸,一般用于人脸注册保存到本地,compare表示从摄像头识别出某个人,一般用于身份鉴权
  • compareImage 人脸对图片,用于mode为recognize识别对比模式时作相机对比图片
  • compareImage.type: 图片类型,值为:url、base64,url表示图片地址,支持本地地址和网络地址,base64表示图片base64的字符串
  • compareImage.value:图片类型对应的值
  • similarity: 相似度,用于mode为recognize模式时相似度大于这个值时认为是同一个人
  • liveness: 是否需要活体识别
  • faceNeedInRect: 人脸是否需要在anchorFrame人脸框内
  • needBase64Image: 识别到的图片是否需要进行base64编码返回,base64编码在Android上比较慢
  • saveImageFilePath: 识别到的图片是否需要保存为文件,如果不需要saveImageFilePath值不用传或传空
  • needFaceFeatureData: 是否需要人脸特征base64后返回

切换相机前后摄像头


this.$refs.arcfacevideo.switchCamera()

识别对比过程中,动态增加对比图片,增加到图片是放到内存


                var params = {};
                params.images = [
                    {
                            type: 'url', //  类型,支持url、base64、faceFeatureData,url表示图片地址,支持本地地址,base64表示图片base64的字符串,faceFeatureData表示人脸特征数据的字符串
                            value: "http://192.168.11.10:8086/image/video_compare_local_image.png",
                            name: "张三"
                    }
                ];
                this.$refs.arcfacevideo.addCompareImage(params);

识别对比过程中,动态删除对比中的图片


                var params = {};
                params.names = [
                    {
                            name: "张三"
                    }
                ];
                this.$refs.arcfacevideo.deleteCompareImage(params);

识别对比过程中,动态删除对比中的所有图片


                this.$refs.arcfacevideo.cleanCompareImage();

事件

@resultCallback mode模式为recognize时,识别到人时回调 mode模式为compare时,识别到人,且大于等于相似度时回调

如果觉得可以就点个👍吧,欢迎粉丝收藏,土豪打赏,您的关注就是我们创作的动力!

隐私、权限声明

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

Android: <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ios: NSCameraUsageDescription

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

插件不采集任何数据

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

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