相信人脸识别功能现在大家都已经不稀奇了，几乎所有的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"}