Android TV(Google TV)中AccessibilityService的onKeyEvent无法触发问题

问题描述 #

我实现了一个简易的AccessibilityService，其中onKeyEvent()方法完全无法被调用，但同一应用的主Activity却能正常捕获相同的按键事件。已确认onServiceConnected()可以正常执行，操作其他应用时也能收到onAccessibilityEvent()回调，之前测试一切正常，近期升级到Android 12固件后出现此问题。

相关代码如下：

服务实现代码（Kotlin） #

class MyAccessibilityService : AccessibilityService() {
    private val myTag= "MyAccessibilityService"

    override fun onAccessibilityEvent(event: AccessibilityEvent?) {
        Log.d(myTag, "onAccessibilityEvent")
    }

    override fun onKeyEvent(event: KeyEvent): Boolean {
        val actionString = when(event.action) {
            KeyEvent.ACTION_DOWN -> "Key Press"
            KeyEvent.ACTION_UP -> "Key Release"
            else -> "Unknown Action"
        }

        Log.d(myTag, "Key event: ${KeyEvent.keyCodeToString(event.keyCode)}, Action: $actionString")

        return super.onKeyEvent(event)
    }


    override fun onInterrupt() {
        // Handle the interruption of the accessibility feedback
    }

    override fun onServiceConnected() {
        super.onServiceConnected()
        Log.d(myTag, "onServiceConnected")
    }

}

无障碍配置文件（res/xml/accessibility_service_config.xml） #

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeContextClicked|typeViewClicked"
    android:packageNames="com.my.myapp"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:notificationTimeout="100"
    android:accessibilityFlags="flagRequestFilterKeyEvents"
    android:canRetrieveWindowContent="true"
    android:canRequestFilterKeyEvents="true" />

Manifest配置 #

<service
    android:name=".MyAccessibilityService"
    android:label="@string/app_name"
    android:exported="true"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>

    <meta-data
        android:name="android.accessibility-service"
        android:resource="@xml/accessibility_service_config" />
</service>

排查与解决步骤 #

1. 处理Android 12的权限变更 #

Android 12对无障碍服务的按键过滤权限做了严格限制：

• 即使配置文件中声明了android:canRequestFilterKeyEvents="true"，也需要用户手动在系统设置-无障碍中找到你的服务，开启"过滤按键事件"的单独开关，该权限默认不会自动启用。

2. 调整配置文件的监听范围 #

• 当前配置中android:packageNames="com.my.myapp"限制了服务仅监听自身应用的事件，但主Activity已经优先捕获了按键事件，导致无障碍服务无法拿到回调。如果需要监听全局按键，直接移除该属性；如果只需要监听特定应用，确保目标应用的Activity没有抢占按键事件。
• 建议修改配置文件的事件类型和包名：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:notificationTimeout="100"
    android:accessibilityFlags="flagRequestFilterKeyEvents"
    android:canRetrieveWindowContent="true"
    android:canRequestFilterKeyEvents="true"
    android:packageNames="" /> <!-- 留空监听所有应用，或指定目标包名 -->

3. 提升服务优先级 #

如果有其他无障碍服务也请求了按键过滤，优先级更高的服务会先获取事件。可以在代码中动态设置更高优先级：

override fun onServiceConnected() {
    super.onServiceConnected()
    Log.d(myTag, "onServiceConnected")
    val serviceInfo = serviceInfo.apply {
        flags = flags or AccessibilityServiceInfo.FLAG_REQUEST_FILTER_KEY_EVENTS
        priority = 1000 // 数值越大优先级越高，范围0-1000
    }
    setServiceInfo(serviceInfo)
}

4. 排除系统按键限制 #

Android 12对电源键、音量键等系统按键的监听有额外限制，部分厂商固件可能进一步收紧权限。先测试返回键、菜单键等普通按键是否能触发onKeyEvent()，确认是否是特定按键的系统级限制。

5. 排查厂商固件定制 #

部分品牌的Android 12固件可能对无障碍服务的按键监听做了白名单或其他定制限制。可以在另一台原生Android 12设备上测试，确认是否是当前固件的问题。

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