相信人脸识别功能现在大家都已经不稀奇了，几乎所有的App里都会支持这个功能。

这里我要问大家一个问题，你们都是如何在自己的App中加入人脸识别功能的呢？

下面，让我们来一步步操作吧！

首先，进入中控易动—提供APP一站式SaaS服务，创建一个应用，创建完成进入应用，然后添加ArcSoftFace插件。

ArcSoftFace插件：提供人脸识别功能

·插件的所有接口在 deviceready 事件后生效;

·虹软创建应用后，需要提供APPID、SDKKEY、Sdk的zip文件(与当前APPID匹配的SDK的压缩包);(参考·ArcSoftFace插件配置)

·当前iOS使用ArcSoftFaceEngine.framework版本是3.0;

当前Android使用ArcSoftFace版本是3.0;

图片模式检测

navigator.arcSoftFace.imageModeCheck(imagePath,success,error)

支持平台：

• Android
• iOS

参数说明

success函数会返回一个对象，其属性包含以下一项或多项：

• num（Int) -- 识别的人脸个数
• beforeImgPath（String) -- 上传图片修改后的待检测的图片路径
• afterImgPath（String) -- 检测后的图片路径
• allFaceData（Array) -- 检测的所有人脸数据，数组里面是每个人脸的对象，该对象其属性包含以下一项或多项：
• bottom（Int) -- 下,Y轴下方对应的值
• top（Int) -- 上,Y轴上方对应的值
• left（Int) -- 左,X轴左方对应的值
• right（Int) -- 右,X轴右方对应的值
• status（Int) -- 状态(0: 正常，其他数值：出错)
• yaw（Number) -- 偏航角
• pitch（Number) -- 俯仰角
• roll（Number) -- 横滚角
• age（String) -- 年龄
• gender（String) -- 性别
• 3DAngle（对象) -- 3D角度信息对象，该对象其属性包含以下一项或多项：
• rect（对象) -- 人脸位置信息对象（该位置对应beforeImgPath的图片），该对象其属性包含以下一项或多项：

error函数会返回一个字符串，检测结果错误的相关信息，错误码在“虹软开发者中心-->帮助中心”查询

示例代码

// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
    navigator.arcSoftFace.imageModeCheck('https://www.yd-mobile.cn/www/photo.jpg',
        function (successCallback) {
            alert(JSON.stringify(successCallback));
        },function (errorCallback) {
            alert(JSON.stringify(errorCallback));
        });
}

响应示例代码：

{
    "allFaceData": [
        {
            "age": "25",
            "gender": "女",
            "3DAngle": {
                "yaw": 7.7150774002075195,
                "status": 0,
                "pitch": -14.829463958740234,
                "roll": -6.1180949211120605
            },
            "rect": {
                "bottom": 228,
                "top": 61,
                "left": 349,
                "right": 516
            }
        }
    ],
    "num": 1,
    "beforeImgPath": "cdvfile://localhost/cache/ArcSoftFace/CacheFace/1583202043544.png",
    "afterImgPath": "cdvfile://localhost/cache/ArcSoftFace/CacheFace/1583202043475.png"
}

图片模式人脸特征对比

navigator.arcSoftFace.faceFeatureComparison(mainImage,contrastImage,success,error)

支持平台：

• Android
• iOS

参数说明

success函数会返回一个字符串，表示比对相似度，取值0-1之间，多人脸显示第一张人脸相似度

error函数会返回一个字符串，比对结果错误的相关信息，错误码在“虹软开发者中心-->帮助中心”查询

示例代码

// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
    navigator.arcSoftFace.faceFeatureComparison('https://www.yd-mobile.cn/www/photo.jpg','https://www.yd-mobile.cn/www/photo.jpg',
        function (success) {
            alert(JSON.stringify(success));
        },
        function (error) {
            alert(JSON.stringify(error));
        }
    );
}

响应示例代码：

'1.000000'

视频模式检测

navigator.arcSoftFace.videoModeCheck(options,success,error)

支持平台：

• Android
• iOS

参数说明

options参数为一个对象，其属性包含以下一项或多项：

• mainImage（String/ 必选) -- 主图路径(被比对图)，支持http://,https://,file://,cdvfile://
• imgPath（String/ 可选) -- 是否存储图片，不添加该参数，则默认为1，可选值(0:存相册，1:存沙盒)

success函数会返回一个对象，其属性包含以下一项或多项：

• num（Int) -- 识别的人脸个数
• similar（Number) -- 比对相似度，取值0-1之间，多人脸显示第一张人脸相似度
• imagePath（String) -- 拍摄的图片的存储路径
• allFaceData（Array) -- 检测的所有人脸数据，数组里面是每个人脸的对象，该对象其属性包含以下一项或多项：
• bottom（Int) -- 下,Y轴下方对应的值
• top（Int) -- 上,Y轴上方对应的值
• left（Int) -- 左,X轴左方对应的值
• right（Int) -- 右,X轴右方对应的值
• status（Int) -- 状态(0: 正常，其他数值：出错)
• yaw（Number) -- 偏航角
• pitch（Number) -- 俯仰角
• roll（Number) -- 横滚角
• age（String) -- 年龄
• gender（String) -- 性别
• 3DAngle（对象) -- 3D角度信息对象，该对象其属性包含以下一项或多项：
• rect（对象) -- 3D角度信息对象（该位置对应imagePath的图片），该对象其属性包含以下一项或多项：

error函数会返回一个字符串，检测结果错误的相关信息，错误码在“虹软开发者中心-->帮助中心”查询

示例代码

// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
    var options = {'mainImage':'https://www.yd-mobile.cn/www/photo.jpg','imgPath':'1'};
    navigator.arcSoftFace.videoModeCheck(options,
        function (success) {
            alert(JSON.stringify(success));
        },
        function (error) {
            alert(JSON.stringify(error));
        }
    );
</script>

响应示例代码：

{
    "allFaceData": [
        {
            "age": "24",
            "gender": "女",
            "3DAngle": {
                "yaw": -0.19426307082176208,
                "status": 0,
                "pitch": -7.769935607910156,
                "roll": 7.534030437469482
            },
            "rect": {
                "bottom": 1128,
                "top": 355,
                "left": -7,
                "right": 765
            }
        }
    ],
    "num": 1,
    "similar": 0.011990511789917946,
    "imagePath": "cdvfile://localhost/cache/ArcSoftFace/1583202179458.png"
}