FireTV App嵌套RecyclerView横向滚动长按右键焦点异常跳转至下一行问题

问题根因 #

Fire TV的Dpad长按会以约50ms/次的速率连续分发KEYCODE_DPAD_RIGHT事件，子RecyclerView处理滚动动画的耗时高于事件分发速率时，系统会误判当前横向方向已无更多可聚焦元素，直接将焦点向上/下传递给父级垂直RecyclerView的下一行，你之前调整滚动速度、基础自定义LayoutManager无效的核心原因是没有解决事件分发速率过快和焦点查找优先级的问题。

可行修复步骤 #

1. 给横向子RecyclerView添加按键事件限流拦截 #

在子RecyclerView的onKeyDown方法中控制同方向按键的最小响应间隔，避免短时间内大量事件涌入导致逻辑判断异常：

private long mLastKeyDownTime = 0;
// 可根据实际滚动流畅度调整间隔，单位ms
private static final long KEY_DOWN_MIN_INTERVAL = 150;

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_DPAD_LEFT || keyCode == KeyEvent.KEYCODE_DPAD_RIGHT) {
        long currentTime = System.currentTimeMillis();
        if (currentTime - mLastKeyDownTime < KEY_DOWN_MIN_INTERVAL) {
            // 小于最小间隔直接消费事件，不触发滚动和焦点判断
            return true;
        }
        mLastKeyDownTime = currentTime;
    }
    return super.onKeyDown(keyCode, event);
}

Kotlin开发可通过setOnKeyListener给子RecyclerView设置对应监听，逻辑完全一致。

2. 重写横向子LayoutManager的焦点查找逻辑 #

强制当横向还有可滚动空间时，拦截垂直方向的焦点查找请求，不让焦点跑出当前横向行：

public class FocusKeepHorizontalLayoutManager extends LinearLayoutManager {
    public FocusKeepHorizontalLayoutManager(Context context, int orientation, boolean reverseLayout) {
        super(context, orientation, reverseLayout);
    }

    @Override
    public View onFocusSearchFailed(View focused, int direction, RecyclerView.Recycler recycler, RecyclerView.State state) {
        // 方向为上下垂直方向时，优先判断横向是否还有可滚动内容
        if (direction == View.FOCUS_UP || direction == View.FOCUS_DOWN) {
            // 还有可滚动空间就返回null，禁止焦点往垂直方向跳转
            if (canScrollHorizontally(1) || canScrollHorizontally(-1)) {
                return null;
            }
        }
        return super.onFocusSearchFailed(focused, direction, recycler, state);
    }
}

3. 给横向子RecyclerView配置必要的焦点属性 #

在XML布局中给横向子RecyclerView加上以下属性，避免父布局抢焦点：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/horizontal_rv"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:descendantFocusability="afterDescendants"
    android:focusable="false"
    app:layoutManager=".FocusKeepHorizontalLayoutManager"
    app:orientation="horizontal" />

验证要点 #

• 长按右键时当前横向行滚动到最右侧后才会跳转到下一行
• 短按滚动、快速切换方向键无卡顿无焦点丢失
• 上下方向键切换横向行的逻辑不受影响

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