更新记录

1.0.0（2026-03-17）

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

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-biometric-auth

austin-biometric-auth 是一个统一的 Android / iOS 生物识别认证插件。

同级 index.vue 是完整模板页，已经带好设备状态、认证方式按钮和常见场景示例，适合直接试用。

重点能力

• getBiometricStatus() 获取当前设备状态
• authenticate(options) 发起认证
• cancelAuthentication() 取消当前认证
• 支持 biometricOnly
• 支持 biometricOrDeviceCredential

宿主配置

• Android：
  • android.permission.USE_BIOMETRIC
  • android.permission.USE_FINGERPRINT
• iOS：
  • NSFaceIDUsageDescription

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

关键字段

getBiometricStatus()

• supported：设备是否支持生物识别
• enrolled：用户是否已录入
• available：当前是否可直接发起认证
• biometryType：当前识别类型
• deviceCredentialSupported：是否支持设备密码兜底
• note：当前状态说明

authenticate(options)

• reason：认证原因，必填
• mode：biometricOnly 或 biometricOrDeviceCredential
• success：成功回调
• fail：失败回调

下面这些字段按需传：

• title
• subtitle
• promptDescription
• cancelText
• fallbackTitle
• confirmationRequired

最小调用

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

const status = getBiometricStatus()

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

注意

• 页面层不用自己区分 Android / iOS
• Android 端最终是人脸还是指纹，很多时候由系统和 ROM 决定
• iOS 上“密码兜底”通常会先尝试 Face ID / Touch ID，再回退设备密码