Android TV与手机应用：RecyclerView的D-pad焦点导航问题

针对你遇到的上下按钮区域+中间RecyclerView布局的D-pad导航需求，我来帮你一步步实现两个焦点控制逻辑：

需求1：按下OK/Enter键，从RecyclerView跳转到第一个子项 #

首先，确保你的RecyclerView本身已经设置为可聚焦（你已经完成这一步，比如添加android:focusable="true"），然后给RecyclerView添加按键监听器，监听OK/Enter键的按下事件，当RecyclerView本身持有焦点时，自动将焦点转移到第一个可见的子项上：

代码实现（Kotlin示例） #

// 在Activity/Fragment中找到你的RecyclerView
val recyclerView = findViewById<RecyclerView>(R.id.recycler)

recyclerView.setOnKeyListener { _, keyCode, event ->
    // 只处理按键按下事件
    if (event.action == KeyEvent.ACTION_DOWN) {
        when (keyCode) {
            // 匹配TV的OK键和手机的Enter键
            KeyEvent.KEYCODE_DPAD_CENTER, KeyEvent.KEYCODE_ENTER -> {
                // 确认当前焦点在RecyclerView本身
                if (recyclerView.hasFocus()) {
                    val layoutManager = recyclerView.layoutManager as LinearLayoutManager
                    // 获取第一个可见的子项位置
                    val firstVisiblePos = layoutManager.findFirstVisibleItemPosition()
                    if (firstVisiblePos != RecyclerView.NO_POSITION) {
                        // 获取对应子项View并请求焦点
                        val firstItemView = layoutManager.findViewByPosition(firstVisiblePos)
                        firstItemView?.requestFocus()
                    }
                    // 消费该事件，避免后续处理
                    return@setOnKeyListener true
                }
            }
        }
    }
    // 不匹配则返回false，交给其他监听器处理
    false
}

关键注意事项 #

• 必须确保你的RecyclerView子项布局的根View设置了android:focusable="true"（如果需要支持触摸场景可以再加android:focusableInTouchMode="true"），否则子项无法获取焦点。

需求2：按下Back/Esc键，从子项回到RecyclerView本身 #

这里有两种常用实现方式，你可以根据自己的场景选择：

方式1：在Adapter中给每个子项添加按键监听 #

这种方式更精准，只针对RecyclerView的子项处理Back键：

// 你的RecyclerView Adapter类
class MyAdapter(private val recyclerView: RecyclerView) : RecyclerView.Adapter<MyAdapter.MyViewHolder>() {

    // ...其他Adapter必要方法...

    override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
        // 绑定数据逻辑...

        // 给子项添加Back键监听
        holder.itemView.setOnKeyListener { _, keyCode, event ->
            if (event.action == KeyEvent.ACTION_DOWN) {
                when (keyCode) {
                    KeyEvent.KEYCODE_BACK, KeyEvent.KEYCODE_ESCAPE -> {
                        // 请求RecyclerView重新获取焦点
                        recyclerView.requestFocus()
                        return@setOnKeyListener true
                    }
                }
            }
            false
        }
    }

    class MyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView)
}

注意：Adapter构造时需要传入RecyclerView的引用，这样才能调用requestFocus()。

方式2：在Activity/Fragment中全局监听Back键 #

如果希望统一处理所有Back键场景，判断当前焦点是否在RecyclerView的子项上：

override fun onBackPressed() {
    val currentFocusedView = currentFocus
    // 检查当前焦点是否是RecyclerView的子元素
    if (currentFocusedView != null && recyclerView.isDescendantOf(currentFocusedView)) {
        // 让RecyclerView重新获取焦点
        recyclerView.requestFocus()
    } else {
        // 其他情况按默认逻辑处理（比如退出页面）
        super.onBackPressed()
    }
}

这种方式同时支持TV的Esc键和手机的Back键，但要注意：如果用户在触摸模式下（手机点击子项）按Back键，也会回到RecyclerView，你可以根据需求添加额外判断（比如判断当前是否是导航模式）。

额外测试建议 #

• 在Android TV模拟器/真机上测试D-pad的上下左右、OK、Back键，确保焦点切换流畅
• 在手机上测试实体键盘的Enter、Back键，以及触摸场景下的焦点行为是否符合预期

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