如何在Android应用中通过代码获取Talkback播报的文本内容

Android系统中，Talkback的播报文本是动态组合生成的，并非直接存储在某个API的返回字段里——它会结合元素的显示文本、控件类型、交互提示等信息拼接而成。要获取完整的播报文本，你可以通过模拟Talkback的拼接逻辑来实现：

1. 获取焦点节点的无障碍信息
   首先需要在AccessibilityService中获取当前拥有焦点的AccessibilityNodeInfo：

   AccessibilityNodeInfo focusedNode = getRootInActiveWindow().findFocus(AccessibilityNodeInfo.FOCUS_INPUT);
   if (focusedNode == null) {
       focusedNode = getRootInActiveWindow().findFocus(AccessibilityNodeInfo.FOCUS_ACCESSIBILITY);
   }
   if (focusedNode == null) {
       // 当前无焦点元素，直接返回空
       return;
   }
   

2. 提取播报所需的核心信息

   • 元素文本：优先取getText()，为空则尝试getContentDescription()（自定义无障碍描述）
   • 控件类型：通过getAccessibilityClassName()获取类名，映射为Talkback播报的通用名称
   • 交互提示：根据元素的可交互属性（如可点击、可滚动）添加对应的操作提示

3. 模拟Talkback的拼接逻辑
   参考系统的播报规则，组合成完整的文本：

   StringBuilder announcement = new StringBuilder();
   
   // 添加元素文本/自定义描述
   CharSequence content = focusedNode.getText();
   if (TextUtils.isEmpty(content)) {
       content = focusedNode.getContentDescription();
   }
   if (!TextUtils.isEmpty(content)) {
       announcement.append(content);
       announcement.append(", ");
   }
   
   // 添加控件类型名称
   String className = focusedNode.getAccessibilityClassName().toString();
   announcement.append(mapClassNameToTypeName(className));
   announcement.append(". ");
   
   // 添加交互操作提示
   if (focusedNode.isClickable()) {
       announcement.append("Double-tap to activate.");
   } else if (focusedNode.isScrollable()) {
       announcement.append("Swipe up or down to scroll.");
   }
   // 可根据控件类型扩展更多提示（如输入框的"Type text"等）
   
   // 最终的完整播报文本
   String fullAnnouncement = announcement.toString();
   

   其中mapClassNameToTypeName方法用于将控件类名转换为Talkback播报的通用名称：

   private String mapClassNameToTypeName(String className) {
       switch (className) {
           case "android.widget.Button":
               return "Button";
           case "android.widget.EditText":
               return "Edit text";
           case "android.widget.CheckBox":
               return "Checkbox";
           case "android.widget.RadioButton":
               return "Radio button";
           // 补充其他常用控件类型
           default:
               // 默认取类名的最后一部分
               return className.substring(className.lastIndexOf(".") + 1);
       }
   }
   

4. 关键注意事项

   • 必须在AccessibilityService中实现，只有无障碍服务能获取系统级的节点信息
   • 不同Android版本的Talkback拼接规则可能略有差异，需根据目标版本调整逻辑
   • 如果元素设置了自定义无障碍播报（如通过AccessibilityNodeInfo.setContentDescription），需优先使用自定义内容

内容的提问来源于stack exchange，提问作者Slavikwin