遥控器焦点如何做到秒选不误触?tv-home 的 D-pad 焦点管理与状态记忆机制深度解析
遥控器焦点如何做到秒选不误触?tv-home 的 D-pad 焦点管理与状态记忆机制深度解析
Android TV 最让人抓狂的体验之一:焦点"漂"了。按下方向键,高亮框却跳去意想不到的位置;打开应用再回到桌面,焦点又莫名回到左上角第一个图标。tv-home 是一款专为 Android TV 打造的 Apple TV 风格极简主页(配合仓库脚本可一键 debloat 掉慢且满是广告的官方桌面),它用不到 900 行纯框架 Java 代码解决了这个问题:每次按键的焦点去向都被显式声明,焦点状态在应用重建、进出应用、甚至卸载重装后都能精准恢复——这就是"秒选不误触"的全部秘密。
一、先看痛点:默认 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() 的焦点回调)会同时触发:
- 卡片以
OvershootInterpolator弹性放大 110%~112%,并升起投影; - 高亮描边与光泽 160ms 淡入;
- dock 上方大标题切换为应用名,底部光晕用
ArgbEvaluator做 450ms 的颜色渐变(颜色取自应用 banner 的主色采样); - 网格中焦点则让光晕淡化到 35%,同时拉下遮罩压暗壁纸,突出应用列表。
这些反馈全部轻量、主线程完成,launcher 整体仅 4.7 MB、无网络请求、无后台服务——快,是它敢做"即时反馈"的前提。
六、配套细节:新装应用不丢焦点
焦点系统最怕"数据变了、视图没变"。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。

