App Inventor 指纹识别怎么用?生物识别(Biometric)组件白屏、不弹窗的排错步骤

« 返回首页

一句话结论: 指纹识别一调用就白屏,九成不是组件坏了,而是两件事没做对——① 在调用验证之前没有先完成「初始化 + 权限申请」,② 真机(或模拟器)本身没录入指纹、没设置锁屏密码。按本文顺序检查,绝大多数白屏和不弹窗都能解决。

实测环境:App Inventor 2 中文网(www.fun123.cn),生物识别(Biometric)为原生组件,支持 Android / iOS / 鸿蒙;测试机为 Android 12(小米)与 Android 13(华为)真机各一台,用 AI 伴侣实时调试 + 编译 APK 验证。

为什么会白屏?

App Inventor 的指纹能力底层走的是系统的 Biometric Prompt(生物识别对话框)。这意味着:

  1. 对话框是系统弹出来的,你的 App 只是发起请求。如果设备没设锁屏密码、没录指纹,系统直接抛运行时错误,界面表现经常就是白屏或闪退,而不是一个友好的提示。
  2. Android 6.0 以上需要运行时权限。 生物识别需要 USE_BIOMETRIC 这类权限,只在清单里声明不够,要在运行时向用户申请(用 Screen 的请求权限方法)。很多「插入积木就白屏」的案例,根因就是权限没申请、初始化顺序不对。
  3. 调用顺序有讲究。 正确顺序是:屏幕初始化时检查设备是否支持、申请权限,然后用户点按钮时才调开始验证。如果你的验证调用写在初始化事件里和别的初始化抢时机,也可能异常。

另外提醒一点:模拟器大多没配置指纹硬件,必须用真机测,这也是很多人反复白屏却找不到原因的原因。

准备工作:先检查手机本身

在动手改积木之前,先用真机确认:

  • 手机已经设置了锁屏密码(图案 / PIN 都行);
  • 在系统设置里录入过至少一枚指纹(华为:设置 → 生物识别和密码;小米:设置 → 密码与安全 → 指纹解锁;OPPO / vivo 类似);
  • 没有被手机管家之类的后台管理强杀权限(可在电池设置里允许应用后台运行,方便调试)。

这三条任何一条不满足,系统都会拒绝弹窗。

完整步骤

第一步:拖入组件

在「传感器」分类里找到 生物识别(Biometric),拖到 Screen1 上(非可视组件)。不需要导入任何 .aix 扩展——中文网已把它做成原生组件,Android、iOS、鸿蒙都能用。注意如果你以前用过第三方指纹扩展,先把它们删掉,避免重复类导致编译报 d8 错误。

第二步:屏幕初始化时申请权限

when Screen1.Initialize() {
  Screen1.AskForPermission("android.permission.USE_BIOMETRIC")
}

when Screen1.PermissionGranted(permissionName) {
  if permissionName = "android.permission.USE_BIOMETRIC" {
    标签_状态.Text = "权限已就绪,可以验证"
  }
}

when Screen1.PermissionDenied(permissionName) {
  标签_状态.Text = "没有权限,指纹无法使用"
}

第三步:按钮触发验证,并处理两种结果

验证一定要由用户动作(点按钮)触发,不要放初始化里。验证的结果有两种事件:验证成功时和验证失败时(用户取消、次数过多被锁定、没录入指纹、设备不支持等都走失败事件,消息 参数是原因)。

when 按钮_指纹登录.Click() {
  生物识别1.Authenticate("请验证指纹以登录", "用你的指纹确认身份")
}

when 生物识别1.AuthSucceeded() {
  标签_状态.Text = "验证通过,进入主页"
}

when 生物识别1.AuthFailed(message) {
  标签_状态.Text = join("验证未通过:", message)
}

想不想允许用户在指纹失败时改输锁屏密码,由组件的「允许设备密码」(AllowDeviceCredential)属性控制:默认关闭;开启后系统对话框里会出现「使用密码」的选项。

常见问题

Q:一插入指纹积木就白屏,是不是组件有 bug? 先别急着换扩展。按这个清单查:① 是不是在真机上调(模拟器基本都不支持);② 手机有没有录指纹、设锁屏;③ 开始验证的参数有没有传错类型——注意别把数字参数填成文本,这是另一类常见报错的来源;④ 权限申请代码有没有加。以上都对了还白屏,可以把报错信息发到社区求助。

Q:提示 Runtime error,比如「没有可用的生物识别硬件」? 这就是设备侧的问题:没录指纹、没设密码,或者手机根本没有指纹模块。验证前可以先调是否可用检查可用性,给用户一个友好提示,而不是直接崩。

Q:AI 伴侣里能用,打包成 APK 就不行(或反过来)? 两种情况都遇到过:伴侣调试时权限继承可能和打包后不同,所以权限申请代码必须写进工程里,不能靠伴侣「已经授权」就偷懒;另外如果你之前给项目加过 .aix 指纹扩展又删得不干净,编译也可能出问题——删组件时确认「传感器」面板里没有残留的非可视组件。

Q:iOS / 鸿蒙上怎么用? 用法和 Android 一样,同一个项目直接编译对应平台的安装包即可。注意 iPhone 用的是 Face ID / 触控 ID,系统会自动选择可用的生物识别方式;鸿蒙设备同样需要在系统设置里录入指纹。第三方 .aix 扩展只能用于 Android,iOS 和鸿蒙不加载扩展,所以做跨平台 App 请务必用原生组件。

Q:指纹验证通过了,登录状态怎么保存? 验证通过只说明「本人操作」,登录态要自己存。简单做法是验证成功后用 TinyDB(微数据库)写一个标记,下次打开 App 时读到标记就跳过验证直接进入主页。

组件参数和事件的完整说明

本文只覆盖了最常用的调用方式。生物识别组件的全部属性、方法和事件(包括可用性检查等高级用法),可以查阅组件中文文档「生物识别」一节,和编辑器里的积木一一对应。

小结

指纹识别本身不复杂,白屏基本都能归到三类:真机没配好(没录指纹 / 没设密码)、权限没在运行时申请、调用时机不对(放初始化而不是用户动作里)。按「检查设备 → 初始化申请权限 → 按钮触发验证 → 分支处理两种结果」这个顺序搭,一次就能跑通。搭好后建议在两台不同品牌的国产手机上各测一遍——不同厂商系统的权限弹窗表现略有差异,提前测能少走弯路。

文档反馈