uexTouchID查看3.0文档

  • 1、简介
  • 2、API概览
  • 3、更新历史

    1、简介

    TouchID苹果指纹识别功能插件
    1.1、说明
    本对象封装了用于调用系统TouchID功能的方法,可以调用系统TouchID验证界面进行指纹识别. TouchID功能接口只适用iOS8.0以上系统且支持指纹识别的设备.
    1.2、UI展示
1.3、开源源码

插件测试用例与源码下载:点击此处

1.4、平台版本支持

本插件的所有API默认只支持iOS8.0+操作系统,不支持Android. 有特殊版本要求的API会在文档中额外说明.

1.5、接口有效性

本插件所有API默认在插件版本4.0.0+可用.
在后续版本中新添加的接口会在文档中额外说明.

2、API概览

2.1、方法
canAuthenticate //校验当前应用是否支持指纹验证

uexTouchID.canAuthenticate(data)

说明:

校验当前应用是否支持指纹验证

参数:

参数名称 参数类型 是否必选 说明
data Object 指纹验证的配置,不需要进行配置时请传null
var data = {
  mode:
}

各字段含义如下:

参数名称 参数类型 是否必选 说明
mode Number 指纹验证模式,详见附录-AuthenticateMode,不传时默认为0

返回值

返回值是一个ErrorCode ,详见附录-ErrorCode,非0时均表示不支持TouchID

示例

var ret = uexTouchID.canAuthenticate({
    mode: 0
});
alert(ret);
authenticate //开始指纹验证

uexTouchID.authenticate (data,cb)

说明:

开始指纹验证

  • 调用此接口时,最好先调用canAuthenticate接口确认当前设备支持TouchID

参数:

参数名称 参数类型 是否必选 说明
data Object 指纹验证的配置,不需要进行配置时请传null
cb Function 指纹验证结果的回调函数
var data = {
  hint:,
  mode:
}

各字段含义如下:

参数名称 参数类型 是否必选 说明
hint String 指纹验证界面的提示语,不传时使用系统默认的提示语
mode Number 指纹验证模式,详见附录-AuthenticateMode,不传时默认为0

回调参数:

var cb = function(error){}
参数名称 参数类型 是否必选 说明
error Number ret是一个ErrorCode ,详见附录-ErrorCode,非0时均表示验证失败

示例

var ret = uexTouchID.canAuthenticate();
if (ret != 0){
    alert("TouchID Unavailable!errorCode: " + ret);
}else{
    uexTouchID.authenticate({
        mode:0,
        hint:"AppCan需要验证您的指纹"
        },
        function(ret){
            if(ret == 0){
                alert("Authentication Succeed!");
            }else{
                alert("Authentication Failed!errorCode:" + ret);
            }
    });
}

3、附录

AuthenticateMode 验证模式

AuthenticateMode 是一个Int类型的枚举值

mode 含义 解释 备注
0 DeviceOwnerAuthenticationWithBiometrics 默认的指纹验证模式,仅当指纹验证通过时返回成功 默认值
1 DeviceOwnerAuthentication 允许用户使用设备密码代替指纹进行验证 需要iOS 9.0+ 系统
  • 当设备不支持所选择的验证模式时,插件会默认验证模式为0
ErrorCode 错误码

ErrorCode 是一个Int类型的枚举值,非零值时均表示操作失败

code 含义 解释 备注
0 NoError 没有发生错误,操作成功
-1 AuthenticationFailed 验证失败
-2 UserCancel 用户取消,用户点击取消按钮时会导致此结果
-3 UserFallback 用户回退,在默认验证模式下用户选择"输入密码"会导致此结果
-4 SystemCancel 系统取消,当另一个应用切换到前台时会导致此结果
-5 PasscodeNotSet 用户没有设置设备密码时,会导致此结果
-6 TouchIDNotAvailable TouchID不可用时会导致此结果,可能是设备不支持或者系统版本太低
-7 TouchIDNotEnrolled 用户设置了设备密码但没有设置指纹时,会导致此结果
-8 TouchIDLockout 用户验证指纹识别错误次数过多会导致此结果
其他情况 UnknownError 未知错误

4、更新历史

iOS

API版本: uexTouchID-4.0.1

最近更新时间:2016-11-29

历史发布版本 更新内容
4.0.1 canAuthenticate接口支持配置mode
Android

uexTouchID不支持Android

历史发布版本 更新内容
还需要帮助吗? 联系我们
最新更新 8th Jul 2021