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

zhichi_admin

如何调用指纹识别接口？

在小程序中，微信为指纹识别提供了两个接口：

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

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

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

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

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

具体代码如下：

[mw_shl_code=applescript,true]if (wx.canIUse('checkIsSupportSoterAuthentication')) { // 检测当前微信版本是否支持调用指纹相关接口  wx.checkIsSupportSoterAuthentication({    success(res) {      console.log(res)    }  })}[/mw_shl_code]

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

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

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

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

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

2. 如何调用指纹识别？

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

示例的代码如下：

[mw_shl_code=applescript,true]wx.startSoterAuthentication({  requestAuthModes: ['fingerPrint'],  challenge: '123456',  authContent: '请用指纹解锁',  success(res) {    // res 中包含授权数据，需要进一步验证正确性  },  fail(res){    console.log('用户取消了指纹识别，或调用出现错误')  }})[/mw_shl_code]

在这个接口中，有这些参数：

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

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

[mw_shl_code=applescript,true]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('当前设备不支持指纹识别')      }    }  })}[/mw_shl_code]

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