用途:使用设备生物识别传感器(Face ID、Touch ID、指纹)对用户进行本地身份验证,可用于应用锁、敏感功能门禁,或会话超时后的二次验证。
主要能力与用法:安装依赖 npm install @aparajita/capacitor-biometric-auth,随后执行 npx cap sync。设置、权限与具体用法参见 setup-and-usage.md。
硬性规则:生物识别只证明用户对设备的本地在场,不等于后端会话,需配合服务器签发的令牌或会话使用。做“应用锁”时,可在 @capacitor/preferences 中存一个标志位,并据此控制路由导航。生物识别失败或不可用时,应提供密码或口令回退。不要用该插件直接“解密”存储的密钥;若需安全隔区支持的密钥存储,应使用基于 iOS Keychain / Android Keystore 的安全存储插件(如 capacitor-secure-storage-plugin,或当前仍在维护的社区包,采用前请在 npm 上核实)。不要每次 API 调用都弹出生物识别,应在应用启动或可配置超时后恢复时进行门禁。
替代方案:@capgo/capacitor-native-biometric 也被广泛使用,两者 API 相似但默认值不同,选定一个并保持一致。
限制:资料未提供具体收费、价格、平台支持范围与效果数据。