使用ComponentActivity.setContent()时丢失首个KeyEvent的问题求助

问题描述 #

在ComponentActivity中重写dispatchKeyEvent本可正常拦截所有按键事件，但添加Compose内容后，首次按下硬件按键时，ACTION_DOWN事件会被Compose消费，仅能收到ACTION_UP，后续按键则恢复正常。

根本原因 #

Compose初始化完成后，首个按键的ACTION_DOWN事件会被Compose的焦点系统捕获，用于触发根布局的焦点请求（对应日志中的Owner FocusChanged(true)），因此该事件不会传递到Activity的dispatchKeyEvent方法。

解决方案 #

方案一：重写dispatchKeyEventBeforeQueue（推荐） #

这个方法的调用优先级高于Compose的事件处理逻辑，会在事件进入窗口事件队列前被触发，能完整捕获所有按键事件，包括首个ACTION_DOWN。

代码示例：

class MainActivity : ComponentActivity() {
    private val TAG = "KeyEventInterceptor"

    override fun dispatchKeyEventBeforeQueue(event: KeyEvent): Boolean {
        Log.d(TAG, "App: $event")
        // 如需拦截事件直接处理，返回true；否则返回false让事件继续传递
        return super.dispatchKeyEventBeforeQueue(event)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            Text("Hello, world!")
        }
    }
}

方案二：禁用Compose根布局自动获取焦点 #

如果不需要Compose布局获取焦点，可以给根可组合项添加Modifier.focusable(false)，阻止焦点系统消费首个按键事件。但此方法会导致整个Compose布局无法获取焦点，不适用于包含输入框等需要焦点控件的场景。

代码示例：

class MainActivity : ComponentActivity() {
    private val TAG = "KeyEventInterceptor"

    override fun dispatchKeyEvent(event: KeyEvent): Boolean {
        Log.d(TAG, "App: $event")
        return super.dispatchKeyEvent(event)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            // 根布局禁用焦点
            Box(Modifier.focusable(false)) {
                Text("Hello, world!")
            }
        }
    }
}

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