Android TV Jetpack Compose存在焦点时BackHandler未触发的问题

在Compose的@Composable函数中添加可聚焦组件后，按下遥控器返回键时，不会立即触发BackHandler事件，只会清除可聚焦组件的焦点，必须再次按下返回键才能触发BackHandler逻辑。需要实现无论当前是否有可聚焦项处于聚焦状态，每次按下返回键都能直接触发BackHandler事件。

场景说明 #

在MainContentScreen中按下D-pad中心键会打开SettingsScreen，该页面包含两个MPButton（显示“Text 1”和“Text 2”），初始焦点默认在“Text 1”上。需要根据这两个按钮的聚焦状态正常处理返回键逻辑。

相关代码 #

App.kt #

@Composable
fun App() {
    val navController = rememberNavController()
    val context = LocalContext.current

    NavHost(navController = navController, startDestination = Splash) {
        composable<Splash> {
            SplashScreen {
                navController.navigate(MainContent) {
                    popUpTo(Splash) { inclusive = true }
                }
            }
        }

        composable<Download> {
            DownloadScreen {
                navController.navigate(MainContent) {
                    popUpTo(Download) { inclusive = true }
                }
            }
        }

        composable<MainContent> {
            MainContentScreen(onBackClick = {
                (context as? ComponentActivity)?.finish()
            })
        }
    }
}

MainContentScreen.kt #

@Composable
fun MainContentScreen(onBackClick: () -> Unit) {
    val focusRequester = remember { FocusRequester() }
    val isSettingOpen = remember { mutableStateOf(false) }

    BackHandler {
        Log.e("TAG", "MainContentScreen: BackHandler")
        if (isSettingOpen.value) {
            isSettingOpen.value = false
        } else {
            onBackClick()
        }
    }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .focusRequester(focusRequester = focusRequester)
            .onDpadCenterClick {
                Log.e("TAG", "MainContentScreen: onDpadCenterClick")
                isSettingOpen.value = true
            }, contentAlignment = Alignment.Center
    ) {
        Text("MainContent Screen")
    }

    if (isSettingOpen.value) {
        SettingsScreen(onBackClick = {
            isSettingOpen.value = false
        })
    }

    LaunchedEffect(Unit) {
        focusRequester.requestFocus()
    }
}

Dpad中心点击扩展函数 #

fun Modifier.onDpadCenterClick(onDpadCenterClick: () -> Unit): Modifier {
    return this.then(Modifier
        .focusable()
        .onKeyEvent { keyEvent ->
        if (keyEvent.nativeKeyEvent.action == KeyEvent.ACTION_UP) {
            when (keyEvent.nativeKeyEvent.keyCode) {
                KeyEvent.KEYCODE_DPAD_CENTER -> {
                    onDpadCenterClick()
                    true // 消费事件
                }

                else -> false
            }
        } else {
            false
        }
    })
}

SettingsScreen.kt #

@Composable
fun SettingsScreen(onBackClick: () -> Unit) {
    val focusRequester = remember { FocusRequester() }
    BackHandler {
        Log.e("TAG", "SettingsScreen: BackHandler Called Close")
        onBackClick()
    }
    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(color = SettingsBG)
            .focusable()
            .focusRequester(focusRequester = focusRequester)
    ) {
        Column {
            MPButton(text = "Text 1") {
                Log.e("TAG", "SettingsScreen: text 1 click")
            }
            MPButton(text = "Text 2") {
                Log.e("TAG", "SettingsScreen: text 2 click")
            }
        }
    }

    LaunchedEffect(Unit) {
        focusRequester.requestFocus()
    }
}

MPButton.kt #

@Composable
fun MPButton(text: String, onClick: () -> Unit) {
    Card(
        modifier = Modifier.padding(all = 10.dp), onClick = onClick
    ) {
        Text(text = text)
    }
}

解决方案 #

问题根源是可聚焦组件默认会消费返回键事件来清除焦点，导致BackHandler无法第一时间捕获事件。可以通过以下两种方式解决：

方案1：拦截返回键事件，禁止组件消费 #

在可聚焦组件的onKeyEvent逻辑中，检测到返回键时不消费事件，让事件继续向上传递到BackHandler。以SettingsScreen为例，修改Box的Modifier：

Box(
    modifier = Modifier
        .fillMaxSize()
        .background(color = SettingsBG)
        .focusable()
        .focusRequester(focusRequester = focusRequester)
        // 添加返回键拦截逻辑
        .onKeyEvent { keyEvent ->
            if (keyEvent.nativeKeyEvent.keyCode == KeyEvent.KEYCODE_BACK 
                && keyEvent.nativeKeyEvent.action == KeyEvent.ACTION_UP) {
                false // 不消费事件，交给BackHandler处理
            } else {
                false
            }
        }
) {
    // 原有内容
}

方案2：主动管理焦点+强制触发BackHandler逻辑 #

通过LocalFocusManager主动控制焦点状态，同时在BackHandler中直接执行逻辑，无需依赖系统默认的焦点清除行为：

@Composable
fun SettingsScreen(onBackClick: () -> Unit) {
    val focusManager = LocalFocusManager.current
    val focusRequester = remember { FocusRequester() }
    
    BackHandler {
        Log.e("TAG", "SettingsScreen: BackHandler Called Close")
        // 可选：主动清除焦点
        focusManager.clearFocus()
        onBackClick()
    }
    
    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(color = SettingsBG)
            .focusable()
            .focusRequester(focusRequester = focusRequester)
    ) {
        Column {
            MPButton(text = "Text 1") {
                Log.e("TAG", "SettingsScreen: text 1 click")
            }
            MPButton(text = "Text 2") {
                Log.e("TAG", "SettingsScreen: text 2 click")
            }
        }
    }

    LaunchedEffect(Unit) {
        focusRequester.requestFocus()
    }
}

关键优化点 #

1. 事件传递优先级：确保返回键事件不被可聚焦组件消费，让BackHandler优先捕获事件。
2. 焦点主动管理：通过LocalFocusManager手动控制焦点状态，避免依赖系统默认行为。
3. BackHandler作用域：SettingsScreen显示时，其BackHandler会优先于MainContentScreen的BackHandler执行（Compose中后组合的BackHandler优先级更高），确保逻辑正确触发。

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