Android自定义View开启无障碍功能时无法接收KeyEvent问题求助

问题根因 #

• 你当前代码未匹配音量加减键对应的键值常量：音量加对应KeyEvent.KEYCODE_VOLUME_UP，音量减对应KeyEvent.KEYCODE_VOLUME_DOWN，所以就算收到事件也不会触发你的逻辑
• 按键事件默认优先由当前活跃的Activity处理，不会直接分发到普通View，只有当View获取到焦点时才会收到按键事件
• 无障碍场景下需要额外配置View的可聚焦属性，保证无障碍焦点可以落到你的自定义View上
• 原代码switch分支存在漏写break的逻辑错误：按下减号、方向左键时，赋值increment = false后没有跳出分支，会继续执行后续加值分支的代码，导致逻辑错误

修复步骤 #

1. 先给自定义View添加焦点相关配置，在自定义View的构造方法中添加如下代码：

// 允许获取普通焦点
setFocusable(true);
// 允许在触摸模式下获取焦点
setFocusableInTouchMode(true);
// 允许获取无障碍焦点
setImportantForAccessibility(View.IMPORTANT_FOR_ACCESSIBILITY_YES);

需要调整数值前主动请求焦点：调用yourCustomView.requestFocus()即可。

2. 修改onKeyDown方法，补充音量键的匹配逻辑，同时修复分支跳转错误：

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (isEnabled()) {
        boolean increment;
        switch (keyCode) {
            case KeyEvent.KEYCODE_DPAD_LEFT:
            case KeyEvent.KEYCODE_MINUS:
            case KeyEvent.KEYCODE_VOLUME_DOWN: // 补充音量减匹配
                increment = false;
                changeValueByOne(increment);
                return true;
            case KeyEvent.KEYCODE_DPAD_RIGHT:
            case KeyEvent.KEYCODE_PLUS:
            case KeyEvent.KEYCODE_EQUALS:
            case KeyEvent.KEYCODE_VOLUME_UP: // 补充音量加匹配
                increment = true;
                changeValueByOne(increment);
                return true;
        }
    }
    return super.onKeyDown(keyCode, event);
}

3. 如果希望当前View持有焦点时优先消费音量键、不触发系统音量调节，可在对应Activity中重写dispatchKeyEvent方法做拦截：

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
    int keyCode = event.getKeyCode();
    // 当自定义View已获取焦点时，将音量键事件直接分发给它
    if ((keyCode == KeyEvent.KEYCODE_VOLUME_UP || keyCode == KeyEvent.KEYCODE_VOLUME_DOWN) 
            && yourCustomView.hasFocus()) {
        return yourCustomView.onKeyDown(keyCode, event);
    }
    return super.dispatchKeyEvent(event);
}

注意事项 #

• 无障碍场景下建议给View添加对应的内容描述，调用setContentDescription()说明该View支持通过音量键调整数值，方便屏幕阅读器播报
• 事件消费完成后返回true即可阻止事件继续传递到系统，避免同时调整系统音量

内容的提问来源于stack exchange，提问作者weei.zh