KeyboardView如何适配Talkback实现按键独立选中与朗读？

默认情况下，Talkback会把整个KeyboardView当作一个独立View处理，只会读取整体的contentDescription。要让每个按键被单独选中并朗读对应的内容，需要通过自定义可访问性代理来拆分按键节点，具体步骤如下：

1. 给按键配置朗读内容 #

在键盘布局xml文件（如res/xml/keyboard.xml）中，给每个<Key>标签添加android:contentDescription，指定该按键的朗读文本：

<Key android:codes="49" android:keyLabel="1" android:contentDescription="数字1"/>
<Key android:codes="-5" android:keyIcon="@drawable/ic_backspace" android:contentDescription="退格键"/>

2. 自定义AccessibilityDelegate拆分节点 #

给KeyboardView设置自定义的可访问性代理，将每个按键包装成独立的可访问节点，让Talkback能识别到单个按键：

KeyboardView keyboardView = findViewById(R.id.keyboardView);
keyboardView.setAccessibilityDelegate(new View.AccessibilityDelegate() {
    @Override
    public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) {
        super.onInitializeAccessibilityNodeInfo(host, info);
        // 清除默认的集合节点配置，避免被识别为整体列表
        info.setCollectionInfo(null);
        info.setCollectionItemInfo(null);
        
        Keyboard keyboard = keyboardView.getKeyboard();
        if (keyboard == null) return;
        
        for (Key key : keyboard.getKeys()) {
            AccessibilityNodeInfo keyNode = AccessibilityNodeInfo.obtain(info);
            // 设置按键在KeyboardView内的坐标区域
            keyNode.setBoundsInParent(new Rect(key.x, key.y, key.x + key.width, key.y + key.height));
            // 绑定按键的朗读内容
            keyNode.setContentDescription(key.contentDescription);
            // 标记按键可点击
            keyNode.setClickable(true);
            // 将按键节点添加到父节点中
            info.addChild(keyNode);
        }
    }
});

3. 处理触摸与焦点逻辑 #

重写KeyboardView的onTouchEvent，当触摸到某个按键时，触发Talkback的焦点与朗读逻辑，同时处理按键点击：

public class CustomKeyboardView extends KeyboardView {
    public CustomKeyboardView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        if (event.getAction() == MotionEvent.ACTION_DOWN) {
            Keyboard keyboard = getKeyboard();
            if (keyboard != null) {
                Key touchedKey = keyboard.getKey((int) event.getX(), (int) event.getY());
                if (touchedKey != null) {
                    // 触发Talkback聚焦并朗读该按键
                    performAccessibilityAction(AccessibilityNodeInfo.ACTION_FOCUS, null);
                    // 执行按键的点击逻辑
                    onKey(touchedKey.codes[0], null);
                }
            }
        }
        return super.onTouchEvent(event);
    }
}

4. 确保KeyboardView可聚焦 #

在布局文件中给KeyboardView设置可聚焦属性，让Talkback能正常导航到键盘区域：

<com.yourpackage.CustomKeyboardView
    android:id="@+id/keyboardView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:focusable="true"
    android:focusableInTouchMode="true"/>

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