faceidCard

cardinfo

base64tofile

概述

faceidCard 封装了faceid开放平台的SDK，集成了faceid身份证扫描识别获取身份证图片功能；可以获取身份证正反面图片和头像图片；开发者需要在FaceID平台上进行SDK网络授权后可以使用，平台地址

App使用场景

扫描获取身份证正面图片和头像图片
扫描获取身份证反面图片

通过身份证图片获取身份证信息

身份证图片获取身份证信息使用faceID平台中身份证识别接口身份证识别接口地址
身份获取信息通过接口获取后可以在应用中生成一个身份证图文信息，如下图

SDK申请授权流程

进入平台后点击控制台到登陆界面
如果没有登陆账号，请点击申请试用，填写信息后，人工联系给与测试授权账号
登陆平台后点击左侧菜单应用配置，然后点击移动端，点击绑定新的Bundle ID
选择平台（Android/IOS）,填写Bundle ID，Bundle ID为Android应用的包名和IOS的Bundle ID
点击确定后等待审核，审核成功后可以使用

netAuth

SDK网络授权

netAuth(callback(ret, err))

ret：

类型：JSON对象
内部字段：

类型：JSON对象
内部字段：


    code: 1     //数字类型；
                //0（成功）
}

示例代码

var faceidCard = api.require('faceidCard');
faceidCard.netAuth(function(ret, err){
    if(ret){
        alert("SDK网络授权成功");
    }else{
        alert('SDK网络授权失败');
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

cardinfo

扫描身份证获取身份证照片信息

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

params

side：

类型：数字类型
描述：身份证正反面
默认值：0
取值范围：
- 0（身份证正面）
- 1（身份证反面）

imgtype：

类型：字符串
描述：扫描身份证成功后获取照片的形式
默认值：file
取值范围：
- file（文件形式）
- base64(base64形式)

ret：

类型：JSON对象
内部字段：

err：

类型：JSON对象
内部字段：

{
    code: 0     //数字类型；
                //错误码：
                //1（获取失败）

示例代码

var faceidCard = api.require('faceidCard');
faceidCard.cardinfo({side:side,imgtype:'file'},
    function(ret,err){        
        if(ret){
            if(ret.base64){
                var portraitImg = ret.base64.portraitImg;
            }
            if(ret.file){
                var portraitImg = ret.file.portraitImg;
                var idcardImg = ret.file.idcardImg;
            }
        }else{
            alert("获取失败");
        }

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

bundleIdentifier

bundleIdentifier(callback(ret, err))

callback(ret, err)

ret：

类型：JSON对象
内部字段：

err：

类型：JSON对象
内部字段：

{
}

var faceidCard = api.require('faceidCard');
faceidCard.bundleIdentifier(function(ret, err){
    if(ret){
        alert("IOS 的 identifier 为"+ ret.identifier);
    }else{
        alert('获取失败');
    }
});

可用性

iOS系统，

可提供的1.0.0及更高版本

base64tofile

图片的base64格式转换成为图片文件

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

params

base64：

类型：字符串类型
描述：图片的base64字符串
默认值：null

callback(ret, err)

ret：

类型：JSON对象
内部字段：

err：

类型：JSON对象
内部字段：无

var faceidCard = api.require('faceidCard');
faceidCard.base64tofile({'base64':ret.base64.portraitImg},function(ret,err){
    if(ret){
        var path = ret.path;
    }else{
        alert("转换失败");
 });

可用性

可提供的1.0.0及更高版本