更新记录

1.0.0（2026-11-05） 下载此版本

1.0.0

• 首个版本，功能可用

平台兼容性

pk-biometric 生物认证套件

指纹 / 面容认证，基于系统级 Soter 协议封装（uni.startSoterAuthentication），零原生插件。认证结果归一化为统一 kind，方便业务分支处理。

为什么做它

Soter API 返回字段零散（isSupport / isEnrolled / errMsg / errCode 三套体系），错误分类（用户取消 / 未录入 / 锁定）每个项目都要重写。pk-biometric 把支持性探测、录入查询、认证发起、错误归类做成四个归一化方法，不支持的端如实返回 unsupported，不造假。

快速上手

import bio from '@/uni_modules/pk-biometric/js_sdk/index.js';

const matrix = await bio.supportMatrix();
// { modes: [...], usable: ['fingerprint'], anyUsable: true }

if (matrix.anyUsable) {
  const r = await bio.authenticate({
    requestAuthModes: ['fingerprint'],
    authContent: '验证身份后进入'
  });
  if (r.kind === 'authenticated') { /* 通过 */ }
  else if (r.kind === 'user-cancel') { /* 用户取消，可重试 */ }
  else if (r.kind === 'not-enrolled') { /* 引导去系统设置录入 */ }
}

全部方法

认证结果 kind 对照

平台支持

• App（Android）：完整支持（指纹为主，部分机型面容）
• App（iOS）：需勾选 FaceID/TouchID 模块后可用
• 小程序：微信支持指纹（Soter 源生协议）
• H5：无 Soter API，isAvailable() 返回 false，业务应降级

示例工程

example/ 为完整可跑工程。在线文档：https://plugins.cnajiu.cn/public/pk-biometric.html