zhichi_admin 发表于 2018-2-5 18:01:02

「小程序能力」如何设置小程序调用指纹识别接口

如何调用指纹识别接口?在小程序中,微信为指纹识别提供了两个接口:
[*]wx.checkIsSupportSoterAuthentication()
[*]wx.startSoterAuthentication()
根据两个接口的名字,我们可以知道:前者用于检查当前设备是否支持生物识别,后者则是实际调用指纹识别的接口。那么,整个调用过程的逻辑就很简单了:先检测当前设备和微信版本是否支持指纹识别,如果支持,则调用指纹识别进行鉴权。
1. 如何检测是否可以调用指纹识别?利用 wx.checkIsSupportSoterAuthentication() 接口和 wx.canIUse() 接口,我们可以检测小程序在当前设备上,是否可以使用指纹识别。具体代码如下:if (wx.canIUse('checkIsSupportSoterAuthentication')) { // 检测当前微信版本是否支持调用指纹相关接口wx.checkIsSupportSoterAuthentication({    success(res) {      console.log(res)    }})}我们从调试台中,可以看到调用结果含有 supportMode 参数,里面包裹一个数组。http://images.ifanr.cn/wp-content/uploads/2017/08/minapp-dev-soter-1.jpg微信小程序官方文档中提到,如果数组中包含有 'fingerPrint',那么就代表当前设备可以使用指纹识别功能。根据以上信息,我们来改写一下代码。if (wx.canIUse('checkIsSupportSoterAuthentication')) {   wx.checkIsSupportSoterAuthentication({    success(res) {      if(res.supportMode == 'fingerPrint'){ // 写法不严谨,正确写法应该是遍历数组查找      // 在此具体调用指纹识别      }else{      console.log('当前设备不支持指纹识别')      }    }})}需要注意的是,如果用户的设备不支持指纹验证,你应该为用户提供替代验证方式。
2. 如何调用指纹识别?确认小程序可以使用指纹识别之后,我们就可以进入正式的接口调用环节了。示例的代码如下:wx.startSoterAuthentication({requestAuthModes: ['fingerPrint'],challenge: '123456',authContent: '请用指纹解锁',success(res) {    // res 中包含授权数据,需要进一步验证正确性},fail(res){    console.log('用户取消了指纹识别,或调用出现错误')}})在这个接口中,有这些参数:
[*]requestAuthModes:允许的生物鉴权方式,以数组的形式呈现。需要指纹识别,只需填入 'finerPrint‘ 。
[*]challenge:官方称为「挑战因子」,可以将请求特征码(订单号、请求编号等)放入,确认用户的是授权哪一个请求。
[*]authContent:在指纹识别的对话框中,向用户显示的提示信息。
将两个接口合并起来用,最终我们的代码效果如下:if (wx.canIUse('checkIsSupportSoterAuthentication')) {   wx.checkIsSupportSoterAuthentication({    success(res) {      if(res.supportMode == 'fingerPrint'){ // 写法不严谨,正确写法应该是遍历数组查找      wx.startSoterAuthentication({          requestAuthModes: ['fingerPrint'],          challenge: '123456',          authContent: '请用指纹解锁',          success(res) {            // res 中包含授权数据,需要进一步验证正确性          },          fail(res){            console.log('用户取消了指纹识别,或调用出现错误')          }      })      }else{      console.log('当前设备不支持指纹识别')      }    }})}
最后我们试着运行一下。看到这样的提示,说明我们的调用成功了:http://images.ifanr.cn/wp-content/uploads/2017/08/minapp-dev-soter-6.jpg
页: [1]
查看完整版本: 「小程序能力」如何设置小程序调用指纹识别接口