Android应用中模拟硬件键盘onKeyDown/onKeyUp事件的实现问题

针对你开发Keyboard Designer时遇到的多按键场景下模拟按键事件的问题，以下是几种有效的解决方式，替代直接调用super.onKeyDown()/super.onKeyUp()的无效方案：

1. 应用内直接构造KeyEvent并分发 #

如果是在自己的Activity或View范围内模拟按键，可手动构造KeyEvent并通过dispatchKeyEvent()分发，能触发自身的onKeyDown()/onKeyUp()回调，且支持多按键组合，无需特殊权限。

// 模拟Ctrl+B的按下与释放流程
// 1. 发送Ctrl键的DOWN事件
KeyEvent ctrlDown = new KeyEvent(
    SystemClock.uptimeMillis(),
    SystemClock.uptimeMillis(),
    KeyEvent.ACTION_DOWN,
    KeyEvent.KEYCODE_CTRL_LEFT,
    0,
    KeyEvent.META_CTRL_ON
);
dispatchKeyEvent(ctrlDown);

// 2. 发送B键的DOWN事件
KeyEvent bDown = new KeyEvent(
    SystemClock.uptimeMillis(),
    SystemClock.uptimeMillis(),
    KeyEvent.ACTION_DOWN,
    KeyEvent.KEYCODE_B,
    0,
    KeyEvent.META_CTRL_ON
);
dispatchKeyEvent(bDown);

// 3. 发送B键的UP事件
KeyEvent bUp = new KeyEvent(
    SystemClock.uptimeMillis(),
    SystemClock.uptimeMillis(),
    KeyEvent.ACTION_UP,
    KeyEvent.KEYCODE_B,
    0,
    KeyEvent.META_CTRL_ON
);
dispatchKeyEvent(bUp);

// 4. 发送Ctrl键的UP事件
KeyEvent ctrlUp = new KeyEvent(
    SystemClock.uptimeMillis(),
    SystemClock.uptimeMillis(),
    KeyEvent.ACTION_UP,
    KeyEvent.KEYCODE_CTRL_LEFT,
    0,
    0
);
dispatchKeyEvent(ctrlUp);

注意：必须严格按照按键按下/释放的顺序发送事件，且使用SystemClock.uptimeMillis()保证时间戳的准确性，系统会依据时间顺序识别多按键组合。

2. 系统级模拟：Instrumentation发送事件 #

如果需要模拟全局的硬件按键事件（比如跨应用的映射），可使用Instrumentation类发送同步按键事件，支持完整的多按键组合模拟。

// 必须在子线程执行，避免阻塞主线程
new Thread(() -> {
    Instrumentation instrumentation = new Instrumentation();
    
    // 模拟单键按下释放
    instrumentation.sendKeyDownUpSync(KeyEvent.KEYCODE_A);
    
    // 模拟Shift+Enter组合键
    instrumentation.sendKeyDownUpSync(KeyEvent.KEYCODE_SHIFT_LEFT);
    instrumentation.sendKeyDownUpSync(KeyEvent.KEYCODE_ENTER);
    instrumentation.sendKeyDownUpSync(KeyEvent.KEYCODE_SHIFT_LEFT);
}).start();

权限要求：需在AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.INJECT_EVENTS" />

注意：普通应用可能无法获取该权限，若面向普通用户，推荐使用下方的无障碍服务方案。

3. 全局按键映射：无障碍服务（AccessibilityService） #

对于需要拦截硬件按键并重新映射的场景，无障碍服务是最优解——它能监听系统级按键事件，拦截原事件后模拟自定义事件，无需INJECT_EVENTS权限，且完美支持多按键组合。

示例代码： #

public class KeyMapAccessibilityService extends AccessibilityService {

    @Override
    public boolean onKeyEvent(KeyEvent event) {
        // 拦截原按键事件：比如将Ctrl+X映射为Ctrl+V
        if (event.getAction() == KeyEvent.ACTION_DOWN 
            && event.getKeyCode() == KeyEvent.KEYCODE_X 
            && event.isCtrlPressed()) {
            
            // 模拟Ctrl+V的按键流程
            new Thread(() -> {
                Instrumentation inst = new Instrumentation();
                inst.sendKeyDownUpSync(KeyEvent.KEYCODE_CTRL_LEFT);
                inst.sendKeyDownUpSync(KeyEvent.KEYCODE_V);
                inst.sendKeyDownUpSync(KeyEvent.KEYCODE_CTRL_LEFT);
            }).start();
            
            return true; // 拦截原事件，不再传递
        }
        return super.onKeyEvent(event);
    }

    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {}

    @Override
    public void onInterrupt() {}
}

配置要求： #

1. 在AndroidManifest.xml中注册服务：

<service
    android:name=".KeyMapAccessibilityService"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_service_config" />
</service>

2. 创建res/xml/accessibility_service_config.xml配置文件：

<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFlags="flagDefault|flagIncludeNotImportantViews|flagRequestFilterKeyEvents"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:canRequestFilterKeyEvents="true"
    android:description="@string/accessibility_service_desc" />

用户需要在系统设置中开启该无障碍服务，才能生效。

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