更新记录

1.0.0（2026-03-17）

• 当前设备生物识别状态展示
• 仅生物识别 / 生物识别或设备密码模式切换
• 登录解锁
• 支付确认
• 查看敏感信息
• 删除前确认
• 取消认证

平台兼容性

uni-app(4.75)

uni-app x(4.75)

其他

点击“试用插件”即可直接体验生物识别认证模板页

试用页面就是插件同级目录下的 index.vue。

页面里已经包含：

• 设备状态检查
• 人脸 / 指纹 / 密码兜底按钮
• 常见认证场景
• 最近一次认证结果

功能特性

• 支持 Android / iOS 统一调用生物识别认证
• 支持查询当前设备是否支持、是否已录入、是否可立即认证
• 支持 biometricOnly
• 支持 biometricOrDeviceCredential
• 支持取消当前认证
• 附带完整模板页，方便直接试用

适用场景

• 登录解锁
• 支付确认
• 敏感信息查看
• 危险操作二次确认

安装

将 uni_modules/austin-biometric-auth 复制到项目的 uni_modules 目录下。

权限说明

Android

• android.permission.USE_BIOMETRIC
• android.permission.USE_FINGERPRINT

iOS

• NSFaceIDUsageDescription

修改这些原生配置后，需要重新编译并重新安装 App / 自定义基座。

API

方法

authenticate(options) 参数

返回值字段

getBiometricStatus() 返回字段

authenticate(options) 返回字段

使用示例

<script>
import { getBiometricStatus, authenticate } from '@/uni_modules/austin-biometric-auth'

export default {
  methods: {
    checkStatus() {
      const status = getBiometricStatus()
      console.log('biometric status', status)
    },

    runAuth() {
      authenticate({
        reason: '请验证身份后继续',
        mode: 'biometricOrDeviceCredential',
        success(res) {
          console.log('认证成功', res)
        },
        fail(err) {
          console.log('认证失败', err)
        },
      })
    },
  },
}
</script>

试用方法

1. 点击“试用插件”
2. 先看设备状态是否支持、是否已录入
3. 选择认证方式
4. 点击常见场景按钮发起认证
5. 查看最近一次认证结果

注意事项

• 页面层不需要自己判断 Android / iOS，直接调用同一套方法即可。
• Android 端最终是人脸还是指纹，很多时候由系统和 ROM 决定。
• iOS 上“密码兜底”通常会先尝试 Face ID / Touch ID，再回退设备密码。