更新记录

1.0.25（2023-10-22）

  1. 修复静态图片问题

1.0.24（2023-10-13）

  1. android sdk升级到3.1

1.0.23（2022-09-18）

ios 虹软sdk更新到3.0.5，适配iOS 16

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间：4.4 - 12.0 armeabi-v7a：未测试，arm64-v8a：未测试，x86：未测试 适用版本区间：9 - 16

原生插件通用使用流程：

  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=6084

虹软SDK版本号： Android:V3.0 ios:V3.0.5

功能

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

虹软开发者平台创建应用

  1. 注册登录虹软开发后台https://ai.arcsoft.com.cn/ucenter/resource/build/index.html#/application

  2. 创建应用 在这里插入图片描述

  3. 选中应用，添加SDK，选择App人脸识别增值版，如果使用的是免费版则选择人脸识别(免费) 在这里插入图片描述在这里插入图片描述 iOS需要绑定包名(这里iOS的包名对应自定义基座时的Bundle ID(AppID))，Android需要绑定包名和签名(这里的包名对应自定义基座时Android包名，这里签名是打包证书对应的sha1值，Android需要使用自有证书才有改sha1),如下图： 在这里插入图片描述在这里插入图片描述

  4. 添加完SDK后获取APP_ID、SDK_KEY 图片.png

    集成原生插件到项目

  5. 插件市场的插件详情页面选择“试用”，绑定项目

  6. HBuilderX项目里，在App原生插件配置的云插件选择插件

  7. 删除本地自定义基座，重新自定义基座

  8. 运行时选择自定义基座运行

这些步骤不熟悉的同学请参考： https://www.jianshu.com/p/830ccc503e29 或 https://blog.csdn.net/wenrisheng/article/details/124057700

使用插件

激活引擎可以放到App.vue的onLaunch里去，每次启动的时候激活就行了 使用之前需要激活引擎，使用上面的APP_ID、SDK_KEY

激活错误码查询:https://ai.arcsoft.com.cn/ucenter/resource/build/index.html#/help


var arcface = uni.requireNativePlugin("wrs-arcface");
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-arcfacevideo ref='arcfacevideo' :style="'width:'+width+'px;height:'+height+'px;'" :config="config" @resultCallback="resultCallback">

</wrs-arcfacevideo>
                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时，识别到人，且大于等于相似度时回调

联系方式：QQ(252797991)

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

隐私、权限声明

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

Android权限： 相机 android.permission.CAMERA 手机状态 android.permission.READ_PHONE_STATE iOS权限： 相机 NSCameraUsageDescription

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

插件不采集任何数据 虹软人脸识别SDK提供本地人脸识别对比功能

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

无

评论列表 撰写评论 向官方投诉
加载更多...
插件问答 我要提问

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

加载更多...