Android 16 在无障碍方向做了两件方向相反但目标一致的事:一手增强语义 API,让应用能把更丰富的 UI 状态准确告诉 TalkBack;另一手收紧权限入口,把 AccessibilityService 的使用范围重新拉回“辅助工具”的定义之内。前者是加法,后者是减法。对应用开发者来说,这意味着适配工作不能只停留在“补几个新方法”,而是要重新审视自己的无障碍实现是否在语义上诚实、在权限上合规。
下面从 API 语义增强 → 废弃公告的替代路径 → isAccessibilityTool 安全模型 → Trae 实操生成与审查 → 真机验证这条链路展开。
UI 语义增强:Android 16 新增的六个无障碍 API
Android 16 为 AccessibilityNodeInfo 和相关的 UI 语义暴露增加了一组新能力,核心思路是让应用能够更精确地描述 UI 状态,减少 TalkBack 依赖启发式推断带来的歧义。
可展开/折叠状态。 新增 setExpandedState,配合发送 TYPE_WINDOW_CONTENT_CHANGED 事件并将内容变更类型设为 CONTENT_CHANGE_TYPE_EXPANDED,可以让 TalkBack 正确播报菜单、下拉列表等交互元素是展开还是折叠。此前这类状态往往只能靠 stateDescription 字符串间接表达,语义不够结构化。
不确定进度条。 新增 RANGE_TYPE_INDETERMINATE,使 RangeInfo 可以同时表达确定进度和不确定进度。ProgressBar 在 indeterminate 模式下终于有了标准化的无障碍语义,TalkBack 不再需要猜测一个没有百分比数值的进度条应该播报什么。
三态复选框。 新增的 getChecked() / setChecked(int) 支持“部分选中”(partially checked)状态,取代已废弃的 isChecked() / setChecked(boolean)。层级树、批量选择等场景中“父节点部分选中”的语义从此可以准确传达。
补充描述。 setSupplementalDescription 允许为 ViewGroup 提供一段附加文本,描述该容器本身的信息,同时不覆盖子视图的内容描述。典型场景是一个字体选择菜单:容器需要说明“字体族”,但当前选中的“Roboto”来自子视图,两者不应该互相覆盖。
必填字段。 setFieldRequired 允许应用向无障碍服务声明表单字段是必填的,帮助用户在表单中一致地识别和快速跳转必填项。
TtsSpan 时长类型。 TtsSpan 新增 TYPE_DURATION,包含 ARG_HOURS、ARG_MINUTES、ARG_SECONDS,让时间表达式的 TTS 播报在不同服务之间更加一致。
多标签关联。 新增 addLabeledBy、removeLabeledBy、getLabeledByList,支持一个 UI 元素关联多个标签,同时废弃旧的 setLabeledBy / getLabeledBy 单标签方法。
此外,Android 16 还引入了文字描边替代高对比度文本的机制,并新增了 AccessibilityManager API 用于查询或注册监听该模式是否启用,主要面向 Compose 等 UI 工具链和自定义文本渲染场景。
废弃 announceForAccessibility:不是移除能力,而是要求更精确的语义
Android 16 废弃了 announceForAccessibility 和 TYPE_ANNOUNCEMENT 事件。原因很直接:这类“广播式”公告对 TalkBack 用户造成的体验是不一致的——它们脱离具体的 UI 上下文,播报时机和内容都难以被辅助技术统一处理。
替代路径按场景拆分:
- 窗口级重大变化:使用
Activity.setTitle(CharSequence)或setAccessibilityPaneTitle(CharSequence),让辅助技术感知到 pane 的标题变化。 - 需要告知用户的关键界面更新:使用
setAccessibilityLiveRegion(int)。在 Compose 中使用Modifier.semantics { liveRegion = LiveRegionMode.Polite }或Assertive,但应谨慎使用,避免每次视图更新都触发播报。 - 错误通知:发送
CONTENT_CHANGE_TYPE_ERROR类型的AccessibilityEvent,并配合AccessibilityNodeInfo.setError(CharSequence)。
这套替代方案的核心变化是:公告从“主动喊话”变成“绑定到具体 UI 状态的语义更新” ,TalkBack 可以根据上下文决定何时、如何播报。
isAccessibilityTool 与 Advanced Protection:权限模型的收紧
Android 16 在安全侧的标志性变化是 Advanced Protection Mode 开始限制 AccessibilityService 的使用范围。未被分类为“无障碍工具”的应用,在高级保护模式开启时,用户将无法授予其无障碍权限,已授予的权限也会被自动撤销。
分类的声明方式是 isAccessibilityTool 属性,位于无障碍服务的 metadata XML 中:
xml
<accessibility-service
android:isAccessibilityTool="true"
... />
官方对“无障碍工具”的定义是主要目标为服务残障用户的应用,包括屏幕阅读器、开关式输入系统、语音输入系统、盲文访问系统等。自动化工具、监控应用、启动器等使用 AccessibilityService 绕过系统限制的应用,属于“非无障碍工具”,应声明 isAccessibilityTool="false"。
这对开发者的影响是实质性的:如果你的应用使用 AccessibilityService 的目的不是直接服务残障用户,就需要为高级保护模式下的功能降级做好准备。单纯在 metadata 中写 true 来“骗过”分类,与平台的安全模型是对抗关系,不是适配策略。
Trae 实操:生成语义增强代码与审查废弃 API
Trae 在这个适配任务中的合理定位是代码生成与静态审查,Android Studio 负责编译和 TalkBack 真机验证。
Step 1:Chat 模式生成可展开组件的无障碍节点信息。 选中一个自定义的可展开 ViewGroup,向 Trae 输入:
“这个 ViewGroup 实现了一个可展开的菜单。在
onInitializeAccessibilityNodeInfo中,用 Android 16 的setExpandedState设置当前展开/折叠状态。展开时状态值为AccessibilityNodeInfo.EXPANDED_STATE_EXPANDED,折叠时为EXPANDED_STATE_COLLAPSED。在状态切换后,发送TYPE_WINDOW_CONTENT_CHANGED事件,内容变更类型设为CONTENT_CHANGE_TYPE_EXPANDED。同时保留对 API 35 及以下的兼容回退,回退到setStateDescription。”
Trae 会生成带版本判断的节点信息覆写代码。这里的关键是让 Trae 明确写出 Build.VERSION.SDK_INT >= 36 的分支,而不是无差别调用新 API。
Step 2:Chat 模式替换废弃公告。 在项目中搜索 announceForAccessibility 和 TYPE_ANNOUNCEMENT,把命中的文件交给 Trae 审查:
“审查这些文件中使用
announceForAccessibility和TYPE_ANNOUNCEMENT的地方。Android 16 已废弃这两种方式。逐一给出替代建议:如果是 Dialog 或窗口标题变化,改用setAccessibilityPaneTitle;如果是列表或文本的关键更新,改用setAccessibilityLiveRegion;如果是错误提示,改用CONTENT_CHANGE_TYPE_ERROR配合setError。不要保留任何announceForAccessibility调用。”
这一步的价值在于让 Trae 做“模式匹配式”的批量替换建议,开发者只需要逐个确认替换场景是否恰当,而不是自己从零遍历整个代码库。
Step 3:Chat 模式生成 AccessibilityManager 的文字描边状态监听。 如果项目中有自定义文本渲染逻辑,向 Trae 输入:
“使用 Android 16 新增的
AccessibilityManagerAPI,检测文字描边(text outline)模式是否启用。提供一个isTextOutlineEnabled()方法,并在onResume中注册监听器,在onPause中注销。注意处理 API 36 以下的兼容性,低版本返回false。”
Step 4:Chat 模式审查 metadata 中的 isAccessibilityTool 声明。 把 res/xml/ 下的无障碍服务配置文件交给 Trae:
“检查这个
accessibility-servicemetadata 是否声明了android:isAccessibilityTool。如果没有,根据这个服务的实际用途给出建议值:如果服务的主要目的是帮助残障用户操作设备,声明true;如果是自动化、增强或工具类用途,声明false。同时检查packageNames和accessibilityFlags是否有过度宽泛的配置,可能导致在高级保护模式下被限制。”
这一步的目的是把安全边界问题显式化,而不是让一个默认的 true 或缺失的声明在高级保护模式下面临被撤销的风险。
真机验证的观察点
编译安装后,在 Android 16 设备上开启 TalkBack,重点验证三件事:可展开组件的状态播报是否从“展开”正确切换为“折叠” ;废弃公告的替代路径是否在窗口切换和列表更新时产生了预期粒度的播报;如果应用声明了 isAccessibilityTool="false",在开启 Advanced Protection Mode 后无障碍权限是否被系统按预期处理。
Android 16 的辅助操作适配,本质上是在 “更精确的语义”和“更严格的权限边界”之间找到各自应用的正确位置。API 增强的部分是增量式的,可以用 Trae 逐模块生成和替换;isAccessibilityTool 和安全模型的部分则是结构性的,需要在 metadata 和产品定位层面做出诚实的判断。把这两件事分开处理,比试图用一套代码同时“讨好”语义和安全两个维度更可持续。