Android TV双横向RecyclerView焦点自动跳转问题解决咨询

嗨，这个问题在Android TV开发里太常见啦！系统默认的焦点导航逻辑会自动寻找相邻的可聚焦视图，所以才会出现滚到第一个RecyclerView最后一项就跳去第二个的情况。我给你几个实用的解决办法，亲测有效：

方案一：自定义RecyclerView拦截焦点搜索 #

这是最稳妥的方式，从RecyclerView的焦点处理逻辑根源上解决问题。我们重写onInterceptFocusSearch方法，当焦点在最后一项且按右方向键时，拦截焦点跳转请求：

首先创建自定义RecyclerView类：

class NoRightJumpRecyclerView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : RecyclerView(context, attrs, defStyleAttr) {

    override fun onInterceptFocusSearch(focused: View?, direction: Int): View? {
        // 仅拦截向右的焦点请求，且当前焦点在最后一项时生效
        if (direction == View.FOCUS_RIGHT) {
            val linearLayoutManager = layoutManager as? LinearLayoutManager ?: return super.onInterceptFocusSearch(focused, direction)
            val lastItemPosition = linearLayoutManager.itemCount - 1
            focused?.let {
                val currentPosition = linearLayoutManager.getPosition(it)
                if (currentPosition == lastItemPosition) {
                    // 返回null表示不进行焦点跳转，保留当前焦点
                    return null
                }
            }
        }
        return super.onInterceptFocusSearch(focused, direction)
    }
}

然后把布局里的第一个RecyclerView替换成这个自定义控件：

<com.your.app.package.NoRightJumpRecyclerView
    android:id="@+id/first_recycler_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" />

方案二：给RecyclerView设置按键监听 #

如果不想自定义控件，也可以直接在Fragment中给第一个RecyclerView添加按键监听，消费掉最后一项的右方向键事件：

firstRecyclerView.setOnKeyListener { _, keyCode, event ->
    if (event.action == KeyEvent.ACTION_DOWN && keyCode == KeyEvent.KEYCODE_DPAD_RIGHT) {
        val layoutManager = firstRecyclerView.layoutManager as? LinearLayoutManager ?: return@setOnKeyListener false
        val focusedChild = firstRecyclerView.findFocusedChild()
        focusedChild?.let {
            val currentPos = layoutManager.getPosition(it)
            val lastPos = layoutManager.itemCount - 1
            if (currentPos == lastPos) {
                // 消费事件，阻止系统处理焦点跳转
                return@setOnKeyListener true
            }
        }
    }
    // 其他情况交给系统处理
    false
}

方案三：设置焦点导航属性（补充方案） #

你也可以尝试给第一个RecyclerView强制设置右焦点的目标为自身，不过这个方法在RecyclerView可滚动时可能优先级不如系统的滚动逻辑，适合作为辅助手段：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/first_recycler_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:nextFocusRight="@id/first_recycler_view"
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" />

注意事项 #

• 确保你的RecyclerView Item布局都设置了android:focusable="true"，否则焦点处理会出现异常；
• 方案一的自定义控件方式是最推荐的，因为它更贴合Android TV的焦点处理机制，稳定性更高。

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