xinyanFaceCheck

• Method

configuration startFaceCheck

论坛示例

为帮助用户更好更快的使用模块，论坛维护了一个示例，示例中包含示例代码、知识点讲解、注意事项等，供您参考。

概述

xinyanFaceCheck是新颜提供的在用户姓名+身份证认证一致的情况下进行活体检测，自动判断画面中的人脸是否为真实人脸，活体检测成功后将活体检测抓取的照片与公安网返回的照片进行比对，输出匹配度，有效防止假冒欺诈。使用之前需要和新颜科技的技术支撑联系，开通模块，并注册应用。联系方式如下：

官网：https://www.xinyan.com/
电话：400-9556-888 传真：021-68811007
邮箱：service@xinyan.com

运行环境

编译时候的固件版本安卓要求4.1.2以上，IOS要求8.0以上

在集成此模块之前需先配置config.xml文件。在config里添加如下字段：

• 名称：xinyanFaceCheck
• 参数：memberId、terminalId、license
• 配置示例:

  <feature name="xinyanFaceCheck">
    <param name="memberId" value="**************" />
    <param name="terminalId" value="**************" />
    <param name="license" value="**************" />
  </feature>

• 字段描述：

memberId：商户号，开通SDK后，新颜提供给商户的唯一编号

terminalId：终端号，开通SDK后，新颜提供给商户的AES终端编号

license：商户的license，license和bundle ID、商户号、终端号绑定唯一，请提前找新颜技术支持申请

模块接口

configuration

配置方法

configuration({params})

params

playSound：

• 类型：布尔类型
• 描述：是否播放声音
• 说明：字段非必填，不填默认true

showInputView：

• 类型：布尔类型
• 描述：是否弹出输入界面
• 说明：字段非必填，不填默认true

inputEditing：

• 类型：布尔类型
• 描述：输入界面是否可编辑
• 说明：字段非必填，不填默认true

backUrl：

• 类型：字符串类型
• 描述：商户后台回调地址
• 说明：字段非必填，不填默认空值

actionType：

• 类型：int类型
• 描述：活体检测的动作类型, 0:眨眼+1个随机动作 1: 眨眼+2个随机动作 2: 眨眼+3个随机动作
• 说明：字段非必填，不填默认0

示例代码

var demo = api.require("xinyanFaceCheck");
// 配置
demo.configuration({
                   playSound : true,
                   showInputView : true,
                   inputEditing : true,
                   backUrl : "",
                   actionType: 1
                   });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

startFaceCheck

开始人像比对

startFaceCheck({params}, callback(ret, err))

params

transId：

• 类型：字符串
• 描述：商户订单号，是商户对这一笔交易的唯一编码，最长允许64位
• 说明：字段必填，不填会返回错误信息msg

idName：

• 类型：字符串
• 描述：姓名
• 说明：字段非必填，不填默认空值

idNo：

• 类型：字符串
• 描述：身份证号
• 说明：字段非必填，不填默认空值

callback(ret, err)

ret：

• 类型：JSON 对象

• 字段说明：

    success // 是否成功
    img // 人脸图片
    idName // 姓名
    idNo // 身份照号
    transId // 商户订单号
    tradeNo // 业务口水号
    fee // 是否收费
    score // 评分分数
    level1 // 千分之一阈值
    level2 // 万分之一阈值
    errorMsg // 返回错误信息
    errorCode // 返回错误码
    step // 认证流程阶段

调用示例代码

var demo = api.require("xinyanFaceCheck");
//开启身份证识别
demo.startFaceCheck({
                    transId : '***',
                    idName  :'***',
                    idNo: '***'
                    },function(ret, err){
                    });

响应码

验证错误

服务端错误码