遥控器焦点如何做到秒选不误触?tv-home 的 D-pad 焦点管理与状态记忆机制深度解析

原创2026-11-02 17:47:281,822 阅读

遥控器焦点如何做到秒选不误触?tv-home 的 D-pad 焦点管理与状态记忆机制深度解析

Android TV 最让人抓狂的体验之一:焦点"漂"了。按下方向键,高亮框却跳去意想不到的位置;打开应用再回到桌面,焦点又莫名回到左上角第一个图标。tv-home 是一款专为 Android TV 打造的 Apple TV 风格极简主页(配合仓库脚本可一键 debloat 掉慢且满是广告的官方桌面),它用不到 900 行纯框架 Java 代码解决了这个问题:每次按键的焦点去向都被显式声明,焦点状态在应用重建、进出应用、甚至卸载重装后都能精准恢复——这就是"秒选不误触"的全部秘密。

tv-home 改造前后对比:左侧是带广告的 Google TV 主页,右侧是干净 dock 与 Lake Louise 壁纸的 tv-home 桌面

一、先看痛点:默认 D-pad 焦点为什么会"迷路"

Android 的焦点系统(D-pad,即方向键导航)默认规则是按几何位置猜测:按"下"时,系统会找正下方距离最近、且"方向正确"的视图。这套规则有两大问题:

  • 猜测有概率:多个候选视图距离相近时,谁被选中取决于布局细节,结果不可预期;
  • 自动滚动打架:ScrollView 默认会自动把获得焦点的子视图滚到可见区域,滚动位置和焦点跳转互相干扰,产生"焦点先跳、画面再窜"的拖影感。

tv-home 的思路很直接:不猜,全部写死。

二、确定性焦点图:wireFocus() 如何为每个视图钉死"下一步"

整个焦点管理的核心是 MainActivity.java 中的 wireFocus()。它在每次构建 UI 后调用,利用 Android 的 setNextFocusLeftId / Right / Up / Down 四组 API,为每一个可聚焦视图明确指定四个方向的下一跳目标:

// Explicit D-pad targets: one row per press, ends of rows and of the top bar don't wrap.
c.setNextFocusLeftId(col == 0 ? c.getId() : gridCards.get(j - 1).getId());
c.setNextFocusRightId(col == cols - 1 || j == g - 1 ? c.getId() : gridCards.get(j + 1).getId());

注释一句话点题:"每次按键恰好走一行,行首尾和顶栏不环绕。"

1. 顶层三枚胶囊(Inputs / Wi-Fi / Settings):小闭环,深跳中

p.setNextFocusLeftId(i == 0 ? p.getId() : pills.get(i - 1).getId());
p.setNextFocusRightId(i == pills.size() - 1 ? p.getId() : pills.get(i + 1).getId());
p.setNextFocusUpId(p.getId());
p.setNextFocusDownId(d > 0 ? dockCards.get(Math.min(d - 1, d / 2)).getId() : p.getId());
  • 左 / 右:在 3 枚胶囊内循环(首项的"左"指向自己,末项的"右"指向自己);
  • 上:指回自身,焦点不会从顶栏"飞出去";
  • 下:直接落到 dock 的中间那张卡片——无论按哪枚胶囊,一次"下"就到了最常用的位置,且落点恒定。

2. Dock 行:上回顶栏、左右顺序走、下钻网格

c.setNextFocusUpId(topId); // 统一回到第一枚胶囊
c.setNextFocusLeftId(i == 0 ? c.getId() : dockCards.get(i - 1).getId());
c.setNextFocusRightId(i == d - 1 ? c.getId() : dockCards.get(i + 1).getId());
c.setNextFocusDownId(g > 0 ? gridCards.get(Math.min(i, g - 1)).getId() : c.getId());

dock 卡片数由 config.xml 的 dock_apps 列表决定(未安装的应用自动跳过),所以 dock 可能是 3 个也可能是 8 个——但无论多少个,焦点路径都是"从左到右顺序走、末端停住",绝不环绕。按"下"则进入网格中同一列位置的第一行。

3. 应用网格:标准行列导航,边界处"停住"而非"环绕"

int r = j / cols, col = j % cols;
c.setNextFocusUpId(r == 0
        ? (d > 0 ? dockCards.get(Math.min(col, d - 1)).getId() : topId)
        : gridCards.get(j - cols).getId());
c.setNextFocusDownId(j + cols < g ? gridCards.get(j + cols).getId()
        : r < lastRow ? gridCards.get(g - 1).getId() : c.getId());

规则非常干净:

按键 行为
上 上一行同行;第一行则回到 dock 的同列(列超界则取最近端)
下 下一行同列;已是最后两行则停在最后一行
左 / 右 行内顺序移动;行首 / 行尾停住,不环绕

"不环绕"是刻意为之:环绕看似方便,却让"我在哪里"变得不可预测。tv-home 用可预测换确定性,用家的次数越多,用户越会形成稳定的空间记忆——这正是"秒选"的心理基础。

💡 同样的手法也用在 Inputs 弹出菜单里:MainActivity.java 为菜单的每一行显式指定上下左右,左 / 右键指向自身,形成一条只能上下的"单向车道"。

三、状态记忆机制:lastFocusedId 让桌面"记得你"

焦点"秒选"的另一半是:回来时焦点还在我刚才放下的地方。tv-home 用了一个极简的字段实现:

private int lastFocusedId = View.NO_ID;
  • 写入:任何视图(dock 卡、网格卡、顶栏胶囊)获得焦点时,回调里执行 lastFocusedId = v.getId()(MainActivity.java);
  • 恢复:三处关键时机都会执行"按 ID 找回视图 → requestFocus()":
时机 位置 行为
应用列表重建 buildApps() 末尾 找到旧 ID 就恢复;找不到(如应用被卸载)则回退到 dock 第一项
从其他应用返回桌面 onResume() 重新聚焦上次停下的卡片,滚动同步回位
在桌面再按 Home 键 onNewIntent() 明确规则:跳回 dock 第一项,并滚回顶部

注意恢复时的防御式设计:findViewById(lastFocusedId) 可能返回 null(视图因卸载而消失),代码会兜底到 dockCards.get(0),永远保证有焦点、永不黑屏。

四、按行滚动:让焦点移动与画面滚动精确同步

tv-home 自定义了 HomeScrollView:

@Override protected int computeScrollDeltaToGetChildRectOnScreen(Rect r) { return 0; }

这一行彻底关闭了 ScrollView 的"自动把焦点子视图滚进屏幕"行为——滚动完全由 scrollToRow() 按行计算:

  • 进入网格第一行:把整个 dock 条滑到屏幕顶边,给网格让位;
  • 之后的每一行:滚动到该行位于屏幕 42% 高度处(人眼最舒适的注视区);
  • 用 Math.max(0, Math.min(target, max)) 双向钳位,永远不会过度滚动。

焦点每移动一格,画面就平滑滚动恰好一行——这就是"落定感"的来源。

五、焦点、光晕与标题:一次按键的完整反馈链

在 tv-home 里,焦点移动从不孤单。每次卡片获得焦点(tile() 的焦点回调)会同时触发:

  1. 卡片以 OvershootInterpolator 弹性放大 110%~112%,并升起投影;
  2. 高亮描边与光泽 160ms 淡入;
  3. dock 上方大标题切换为应用名,底部光晕用 ArgbEvaluator 做 450ms 的颜色渐变(颜色取自应用 banner 的主色采样);
  4. 网格中焦点则让光晕淡化到 35%,同时拉下遮罩压暗壁纸,突出应用列表。

这些反馈全部轻量、主线程完成,launcher 整体仅 4.7 MB、无网络请求、无后台服务——快,是它敢做"即时反馈"的前提。

tv-home 桌面背景:Lake Louise 自然风景壁纸,来自 launcher/assets/wallpapers 素材库

六、配套细节:新装应用不丢焦点

焦点系统最怕"数据变了、视图没变"。tv-home 用了双保险:

  • 注册 ACTION_PACKAGE_ADDED / REMOVED / CHANGED 广播(onCreate 中注册),装 / 卸应用时立即重建列表;
  • 针对"安装发生在别的 App 在前台、广播被漏掉"的真实翻车场景,每次 onResume 还会用 getChangedPackages(packageSeq) 的序列号再对账一次(MainActivity.java),有变化就重建。

重建后 lastFocusedId 依然生效,焦点稳稳落回原卡片。配合 AndroidManifest.xml 中 singleTask + clearTaskOnLaunch 的 Activity 配置,Home 键行为也彻底确定:永远一个干净的桌面,永远一个明确的焦点起点。

七、总结:秒选不误触 = 显式焦点图 + 焦点记忆 + 按行滚动

tv-home 并没有使用任何黑科技,它只是把 Android TV 焦点管理里最容易"偷懒"的三件事做成了确定性设计:

机制 做法 源码位置
确定性焦点图 每个视图四方向下一跳全部显式指定,不环绕 wireFocus()
状态记忆 lastFocusedId + 三处恢复时机 + 空值兜底 MainActivity.java
按行滚动 关闭 ScrollView 自动滚动,按 42% 屏高逐行钳位 HomeScrollView

对新手做 TV 界面开发,这是最值得抄作业的一点:别把焦点交给几何猜测,把每一次按键写成一句"从 A 到 B",再把"上一次停在哪"记下来。剩下的,用户自然会感到"这台电视的遥控器,快得离谱"。

📌 想动手体验:dock 应用、隐藏应用和网格列数都在 launcher/res/values/config.xml 里改,改完执行 launcher/build-and-install.sh 即可;具体 TV 型号的 debloat 清单参考 examples/tcl-google-tv-g07/debloat.txt。

登录后查看全文
tv-home