微信小程序开发|教程|文档|资源汇总_即速论坛

 找回密码
 立即注册

扫一扫,访问微社区

查看: 6000|回复: 1

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

[复制链接]

910

主题

2100

帖子

3万

金钱

管理员

论坛管理员

Rank: 9Rank: 9Rank: 9

积分
0

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

QQ
发表于 2018-2-5 18:01:02 | 显示全部楼层 |阅读模式
如何调用指纹识别接口?

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

  • 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]


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

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|小黑屋|微信小程序开发|教程|文档|资源汇总_即速论坛 ( 粤ICP备14097199号-1  

GMT+8, 2022-9-25 14:10 , Processed in 0.077938 second(s), 29 queries .

Powered by Discuz! X3.4

Copyright © 2001-2021, Tencent Cloud.

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