如何使用 wx.checkIsSoterEnrolledInDevice 查询是否已录入生物认证信息？

推荐答案

// www.javascriptcn.com code example
wx.checkIsSoterEnrolledInDevice({
  checkAuthMode: 'fingerPrint', // 检查的生物认证模式，如指纹
  success(res) {
    console.log('是否已录入生物认证信息:', res.isEnrolled);
  },
  fail(err) {
    console.error('查询失败:', err);
  }
});

本题详细解读

1. 方法介绍

wx.checkIsSoterEnrolledInDevice 是微信小程序提供的一个 API，用于查询设备是否已经录入了指定的生物认证信息（如指纹、面部识别等）。该方法可以帮助开发者在进行生物认证之前，先确认用户是否已经录入了相应的生物信息。

2. 参数说明

• checkAuthMode: 必填参数，指定要检查的生物认证模式。常见的值包括：
  • fingerPrint: 指纹识别
  • facial: 面部识别
  • speech: 声纹识别

3. 返回值

• success: 查询成功时的回调函数，返回一个对象 res，其中 res.isEnrolled 是一个布尔值，表示是否已录入指定的生物认证信息。
• fail: 查询失败时的回调函数，返回错误信息 err。

4. 使用场景

• 在需要进行生物认证的场景中，先调用此方法确认用户是否已经录入了相应的生物信息，避免在未录入的情况下直接调用认证接口导致失败。
• 可以用于引导用户录入生物信息，提升用户体验。

5. 注意事项

• 该方法仅用于查询是否已录入生物认证信息，并不进行实际的认证操作。
• 不同设备的生物认证支持情况可能不同，建议在使用前先调用 wx.getSystemInfo 获取设备信息，确认设备是否支持相应的生物认证功能。