宜信同城网交流论坛

 找回密码
 立即注册
开启左侧

fingerprint模块管理指纹识别

[复制链接]
发表于 2023-2-16 18:54:53 | 显示全部楼层 |阅读模式 来自 LAN

Android平台6.0及以上系统支持,仅适配Google官方指纹识别的标准接口的设备。

方法:

对象:

回调方法:

权限:

5+功能模块(permissions)

 

isSupport

当前设备环境是否支持指纹识别

 

说明:

目前还有很多设备没有指纹识别模块,需要调用此方法判断是否可使用指纹识别功能。

参数:

返回值:

Boolean : 设备支持指纹识别则返回true,否则返回false。

示例:

 

uni-app使用plus注意事项

isKeyguardSecure

当前设备是否设置密码锁屏

 

说明:

如果设备没有设置密码锁屏,则无法使用指纹识别功能,建议调用指纹识别前先使用此接口检查。 调用plus.fingerprint.authenticate会返回失败。

参数:

返回值:

Boolean : 设备已设置密码锁屏则返回true,否则返回false。

平台支持:

  • Android (支持) :

    要求设置密码锁屏才可以使用指纹识别,如果没有设置密码锁屏应该提示用户进行设置。

  • iOS (不支持) :

    不支持此功能,返回true。

示例:

 

uni-app使用plus注意事项

isEnrolledFingerprints

当前设备是否已经录入指纹

 

说明:

如果设备没有录入指纹,则无法使用指纹识别功能,建议调用指纹识别前先使用此接口检查。 调用plus.fingerprint.authenticate会返回失败。

参数:

返回值:

Boolean : 设备已经录入指纹则返回true,否则返回false。

示例:

 

uni-app使用plus注意事项

authenticate

指纹识别认证

 

说明:

用户可以开始输入指纹进行识别,如果认证成功则触发successCB回调,识别失败则触发errorCB回调返回错误信息。

参数:

  • successCB: FingerprintSuccessCallback ) 必选 识别认证成功回调

    指纹识别操作认证成功时调用。

  • errorCB: FingerprintErrorCallback ) 必选

    指纹识别操作认证失败时调用,每次指纹识别错误都会触发一次错误回调。

  • options: AuthenticateOptions ) 可选 识别认证参数

    用于设置指纹识别界面显示的提示信息等。

返回值:

void : 无

平台支持:

  • Android (支持) :

    指纹识别过程中不会弹出任何界面,需要开发者根据业务需求弹出提示信息。

  • iOS (支持) :

    指纹识别过程中会弹出系统界面。

示例:

 

uni-app使用plus注意事项

cancel

取消指纹识别认证

 

说明:

取消当前正在处理的指纹识别认证操作。 如果当前没有进行指纹识别则不进行任何操作;如果当前正在进行指纹识别则触发错误回调(错误码为“CANCEL”)。

参数:

返回值:

void : 无

示例:

 

uni-app使用plus注意事项

AuthenticateOptions

JSON对象,指纹识别认证参数

 

说明:

用于设置指纹识别认证界面显示的提示信息等。

属性:

  • message: (String 类型 )在指纹识别过程中显示在界面上的提示信息

    如果指纹识别认证过程中不显示提示框,则不显示此信息。

    平台支持

    • Android - (不支持) :

      指纹识别认证过程中不显示提示框,需要开发者自定义显示。

    • iOS - (支持) :

      指纹识别认证过程中显示系统提示框,在提示框中显示此信息(默认显示信息为空字符串)。

     

FingerprintError

JSON对象,指纹识别错误信息

 

常量:

  • UNSUPPORT: (Number 类型 )不支持指纹识别

    当前设备不支持指纹识别功能时返回此错误,错误代码常量值为1。

  • KEYGUARD_INSECURE: (Number 类型 )设备未设置密码锁屏

    当前设备为设置密码锁屏导致无法使用指纹识别功能时返回此错误,错误代码常量值为2。

  • FINGERPRINT_UNENROLLED: (Number 类型 )未录入指纹识别

    当前设备未录入指纹导致无法使用指纹识别功能时返回此错误,错误代码常量值为3。

  • AUTHENTICATE_MISMATCH: (Number 类型 )指纹识别不匹配

    用户指纹识别认证不通过时返回此错误,错误代码常量值为4。 用户每次尝试指纹识别认证未通过都会触发此错误,此时还可以继续识别认证。

  • AUTHENTICATE_OVERLIMIT: (Number 类型 )指纹识别次数超过限制

    用户多次指纹识别认证不通过时返回此错误,错误代码常量值为5。 通常出现此错误后系统会锁定一段时间禁止使用指纹识别,如果再次调用指纹识别认证会立即返回此错误,因此出现此错误时应该提示用户使用其它方式进行认证。

  • CANCEL: (Number 类型 )取消指纹识别

    用户取消指纹识别认证时返回此错误,错误代码常量值为6。

  • UNKNOWN_ERROR: (Number 类型 )未知错误

    其它未知错误,错误代码常量值为7。

属性:

  • code: (Number 类型 )错误代码

    取值范围为FingerprintError对象的错误常量值。

  • message: (String 类型 )错误描述信息

    详细错误描述信息。

FingerprintSuccessCallback

指纹识别认证成功回调函数

 

参数:

返回值:

void : 无

示例:

 

uni-app使用plus注意事项

FingerprintErrorCallback

指纹识别认证失败的回调函数

 

参数:

  • error: FingerprintError ) 必选 获取加速度操作的错误信息

    可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。

返回值:

void : 无

示例:


                
宜信网交流论坛 - 版权声明 1、在发表言论时,请遵守当地法律法规。主题所有言论纯属个人意见,与本站立场无关。
2、本站所有主题由作者发表,作者享有帖子相关版权,其他单位或个人使用、转载或引用本文时必须征得作者同意并注明来源于宜信网
3、如本帖侵犯到任何版权问题,请立即告知本站,本站将及时予与删除并致以最深的歉意。
4、帖子不遵守当地法律法规、广告、人身攻击等情况时,宜信网管理人员有权不事先通知发贴者而删除本文。
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|Archiver|手机版|小黑屋|宜信同城网交流论坛 ( 闽ICP备19021048号 )|站点地图

GMT+8, 2026-3-28 03:20 , Processed in 0.317535 second(s), 13 queries , Redis On.

Powered by Discuz! X3.4

Copyright © 2001-2020, Tencent Cloud.

快速回复 返回顶部 返回列表