用户
 找回密码
 立即注册

QQ登录

只需一步,快速开始

搜索
  • TA的每日心情
    无聊
    2017-8-15 16:38
  • 签到天数: 42 天

    [LV.5]常住居民I

    877

    主题

    2066

    帖子

    3万

    金钱

    管理员

    论坛管理员

    Rank: 9Rank: 9Rank: 9

    积分
    0

    突出贡献优秀版主荣誉管理论坛元老

    QQ
    2018-2-5 18:01:02 zhichi_admin 管理员 楼主 12293
    如何调用指纹识别接口?

    小程序中,微信为指纹识别提供了两个接口:

    • wx.checkIsSupportSoterAuthentication()
    • wx.startSoterAuthentication()

    根据两个接口的名字,我们可以知道:前者用于检查当前设备是否支持生物识别,后者则是实际调用指纹识别的接口。

    那么,整个调用过程的逻辑就很简单了:先检测当前设备和微信版本是否支持指纹识别,如果支持,则调用指纹识别进行鉴权。


    1. 如何检测是否可以调用指纹识别?

    利用 wx.checkIsSupportSoterAuthentication() 接口和 wx.canIUse() 接口,我们可以检测小程序在当前设备上,是否可以使用指纹识别。

    具体代码如下:

    [AppleScript] 纯文本查看 复制代码
    if (wx.canIUse('checkIsSupportSoterAuthentication')) { // 检测当前微信版本是否支持调用指纹相关接口  wx.checkIsSupportSoterAuthentication({    success(res) {      console.log(res)    }  })}

    我们从调试台中,可以看到调用结果含有 supportMode 参数,里面包裹一个数组。

    微信小程序官方文档中提到,如果数组中包含有 'fingerPrint',那么就代表当前设备可以使用指纹识别功能。

    根据以上信息,我们来改写一下代码。

    [AppleScript] 纯文本查看 复制代码
    if (wx.canIUse('checkIsSupportSoterAuthentication')) {   wx.checkIsSupportSoterAuthentication({    success(res) {      if(res.supportMode[0] == 'fingerPrint'){ // 写法不严谨,正确写法应该是遍历数组查找        // 在此具体调用指纹识别      }else{        console.log('当前设备不支持指纹识别')      }    }  })}

    需要注意的是,如果用户的设备不支持指纹验证,你应该为用户提供替代验证方式。


    2. 如何调用指纹识别?

    确认小程序可以使用指纹识别之后,我们就可以进入正式的接口调用环节了。

    示例的代码如下:

    [AppleScript] 纯文本查看 复制代码
    wx.startSoterAuthentication({  requestAuthModes: ['fingerPrint'],  challenge: '123456',  authContent: '请用指纹解锁',  success(res) {    // res 中包含授权数据,需要进一步验证正确性  },  fail(res){    console.log('用户取消了指纹识别,或调用出现错误')  }})

    在这个接口中,有这些参数:

    • requestAuthModes:允许的生物鉴权方式,以数组的形式呈现。需要指纹识别,只需填入 'finerPrint‘ 。
    • challenge:官方称为「挑战因子」,可以将请求特征码(订单号、请求编号等)放入,确认用户的是授权哪一个请求。
    • authContent:在指纹识别的对话框中,向用户显示的提示信息。

    将两个接口合并起来用,最终我们的代码效果如下:

    [AppleScript] 纯文本查看 复制代码
    if (wx.canIUse('checkIsSupportSoterAuthentication')) {   wx.checkIsSupportSoterAuthentication({    success(res) {      if(res.supportMode[0] == 'fingerPrint'){ // 写法不严谨,正确写法应该是遍历数组查找        wx.startSoterAuthentication({          requestAuthModes: ['fingerPrint'],          challenge: '123456',          authContent: '请用指纹解锁',          success(res) {            // res 中包含授权数据,需要进一步验证正确性          },          fail(res){            console.log('用户取消了指纹识别,或调用出现错误')          }        })      }else{        console.log('当前设备不支持指纹识别')      }    }  })}


    最后我们试着运行一下。看到这样的提示,说明我们的调用成功了:

    使用道具 举报 回复
    发新帖
    您需要登录后才可以回帖 登录 | 立即注册
    咫尺论坛|小程序开发社区
    X

    扫码添加专属客服即可随时咨询

    还可领取小程序推广攻略