Accessibility Service真机无法接收onKeyEvent，模拟器运行正常

我正在开发一个用于接收按键事件的Accessibility Service，代码和配置如下：

Service代码（testService.java） #

public class testService extends AccessibilityService {

    @Override
    public void onAccessibilityEvent(AccessibilityEvent accessibilityEvent) {
        
    }

    @Override
    protected void onServiceConnected() {
        AccessibilityServiceInfo info = new AccessibilityServiceInfo();
        info.eventTypes = AccessibilityEvent.TYPES_ALL_MASK;
        info.feedbackType = AccessibilityServiceInfo.FEEDBACK_ALL_MASK;
        info.flags = AccessibilityServiceInfo.FLAG_REQUEST_FILTER_KEY_EVENTS |
                AccessibilityServiceInfo.FLAG_INCLUDE_NOT_IMPORTANT_VIEWS |
                AccessibilityServiceInfo.FLAG_REPORT_VIEW_IDS |
                AccessibilityServiceInfo.FLAG_RETRIEVE_INTERACTIVE_WINDOWS;
        info.notificationTimeout = 100;
        setServiceInfo(info);
    }

    @Override
    public void onInterrupt() {

    }

    @Override
    protected boolean onKeyEvent(KeyEvent event) {

        int action = event.getAction();

        // 监听按键抬起事件
        if (action == KeyEvent.ACTION_UP) {
            int unicodeChar = event.getUnicodeChar();
            if (unicodeChar > 0) {
                char asciiChar = (char) unicodeChar;
                // TODO: 处理逻辑
            }
        }

        return super.onKeyEvent(event);
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
    }
}

AndroidManifest.xml配置 #

<service
            android:name=".testService"
            android:enabled="true"
            android:exported="false"
            android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE"
            android:label="">
            <intent-filter>
                <action android:name="android.accessibilityservice.AccessibilityService" />
            </intent-filter>
            <meta-data
                android:name="android.accessibilityservice"
                android:resource="@xml/accessibility_service_config" />
        </service>

该服务在多版本Android模拟器上均可正常接收按键事件，但在真实物理设备上无法工作。怀疑真机中有其他程序先消耗了按键事件，请问如何排查解决？

1. 强制设置无障碍服务最高优先级 #

Android系统中，无障碍服务的优先级决定事件接收顺序，优先级高的服务先拿到事件。务必在accessibility_service_config.xml中明确设置最高优先级（范围1-100）：

<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFeedbackType="feedbackAllMask"
    android:accessibilityFlags="flagRequestFilterKeyEvents|flagIncludeNotImportantViews|flagReportViewIds|flagRetrieveInteractiveWindows"
    android:notificationTimeout="100"
    android:priority="100" />

注意：部分厂商设备优先读取XML配置的优先级，代码中设置的参数可能被覆盖。

2. 加日志验证事件是否到达服务 #

在onKeyEvent方法中添加日志输出，确认事件是否真的传递到你的服务：

@Override
protected boolean onKeyEvent(KeyEvent event) {
    Log.d("KeyService", "收到按键事件：动作=" + event.getAction() + "，键码=" + event.getKeyCode());
    int action = event.getAction();

    if (action == KeyEvent.ACTION_UP) {
        int unicodeChar = event.getUnicodeChar();
        if (unicodeChar > 0) {
            char asciiChar = (char) unicodeChar;
            Log.d("KeyService", "按下字符：" + asciiChar);
        }
    }

    return super.onKeyEvent(event);
}

如果无日志输出，说明事件根本没传到服务；如果有输出，再排查后续处理逻辑。

3. 排查厂商系统的特殊限制 #

国产厂商（小米、华为、vivo等）通常会对无障碍服务做额外限制：

• 确认无障碍权限真正激活：部分设备需要在设置中手动确认服务处于开启状态，甚至需要重启服务生效。
• 关闭其他抢事件的应用：输入法、悬浮球、手势工具、手机管家类应用可能会优先拦截按键事件，临时关闭后测试。
• 开放后台权限：开启「自启动权限」「后台弹出界面」「电池优化豁免」，避免系统在后台杀死服务或限制其运行。

4. 修改事件消费返回值 #

当前返回super.onKeyEvent(event)会让事件继续向下传递，若要优先处理事件，可尝试返回true（表示事件已被消费，不再传递），测试是否能正常接收：

return true; // 替换原有的super.onKeyEvent(event)

注意：返回true后后续服务将无法收到该事件，需根据业务需求调整。

5. 区分普通按键与系统按键测试 #

部分物理设备的系统按键（电源键、音量键、Home键）有系统级拦截，先测试普通字母/数字按键是否能接收；若要监听系统按键，需确认厂商是否允许第三方服务获取这类事件权限。

6. 检查服务是否被系统杀死 #

在onDestroy方法中加日志，确认服务是否被意外终止：

@Override
public void onDestroy() {
    Log.d("KeyService", "服务被销毁");
    super.onDestroy();
}

如果频繁被杀死，需申请「电池优化豁免」权限，避免系统在后台回收服务。

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