touchID

来自于:官方立即使用

概述

touchID封装了iphone5s以后版本的手机特有的指纹识别功能,调用此模块可实现用户指纹输入验证登陆app 。使用本模块需要支持指纹识别的手机和iOS8.0以上的操作系统

图片说明

isValid

当前设备是否支持指纹识别功能

isValid()

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:  //布尔类型;是否支持,true|false
}

示例代码

var touchID = api.require('touchID');
touchID.isValid(function(ret) {
    if (ret.status) {
        api.alert({ msg: "支持指纹识别功能!" });
    } else {
        api.alert({ msg: "不支持指纹识别功能!" });
    }
});

可用性

iOS8 及以上系统

可提供的1.0.0及更高版本

verify

弹出验证界面,验证用户指纹

verify({params},callback())

params

title:

  • 类型:字符串
  • 描述:(可选项)验证弹框的标题
  • 默认值:验证指纹密码

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:  //布尔类型;是否验证通过,true|false
    code:    //数字类型;返回验证未通过信息,参数说明如下:
              0:    //用户选择手动输入
              1:    //用户取消验证
              2:    //验证三次失败
              3:    //多次验证失败
              4:    //验证失败,未知错误
              5:    //用户未开启指纹验证设备
}

示例代码

var touchID = api.require('touchID');
touchID.verify({
   title: '验证指纹'
}, function(ret) {
        if (ret.status) {
            api.alert({ msg: "验证通过" });
        } else {
            if (ret.code == 0) {
                api.alert({ msg: "用户选择手动输入" });
            } else if (ret.code == 1) {
                api.alert({ msg: "用户取消验证" });
            } else if (ret.code == 2) {
                api.alert({ msg: "验证三次失败" });
            } else if (ret.code == 3) {
                api.alert({ msg: "多长验证失败请锁定手机" });
            } else {
                api.alert({ msg: "验证失败,未知错误" });
            }
        }
    });

可用性

iOS8及以上系统

可提供的1.0.0及更高版本