电视端应用开发

项目背景

这是一套面向电视端大屏的应用与智能硬件配套工程，主代码为 C 实现，工程内另有 56 个 Java 文件作为伴生代码（用于上层应用部分），最后一次提交在 2025 年 10 月。目标设备是 Android TV 一类的电视端大屏，交互方式是遥控器而不是触摸屏。

客户当时的状态

把手机上的应用搬到电视上，是这类项目最常见的起点，也是最容易翻车的地方。电视端没有触摸，全靠遥控器上下左右加确认键，界面元素的焦点顺序、回退逻辑、编辑类操作（比如输入文字）在电视上都需要重新设计；屏幕尺寸和观看距离也不一样，手机端的字号和间距直接放大到电视上会显得很粗糙。加上电视设备的芯片、系统版本差异很大，同一套界面在不同机型上的表现可能不一致。

我们的做法与取舍

第一个取舍是把焦点导航当作一等公民来设计，而不是等界面做完再补。焦点从哪里开始、按一下去哪个元素、按返回回到哪里，这些必须在布局阶段就定下来，事后补会推翻大量界面。

第二个取舍是明确原生层与上层应用的边界。工程里 C 代码与 Java 代码并存，各自承担的职责必须划清——哪些逻辑放在原生层、哪些放在上层应用，接口如何约定。边界不清，两边都会往中间写，后面谁也理不顺。

第三个取舍是正视设备碎片化，不假设「一台上跑通就等于都跑通」。机型适配是这类项目的固定成本，需要按目标机型清单逐个确认，而不是上线后被动处理。

系统怎么承载这条链路

系统分层：原生层用 C 实现底层的核心能力，上层应用由 Java 伴生代码承担界面与业务交互，面向 Android TV 的遥控器操作模型。界面按大屏布局组织，导航路径以遥控器输入为准。整体结构是为电视端设计的，不是手机端应用的尺寸放大版。

交付状态与边界

代码库最近一次提交在 2025 年 10 月，处于维护状态。边界说明：交付的是电视端应用与配套的原生层能力；硬件本体的设计与生产不在范围内，我们做的是软件侧的能力与适配；可运行的机型范围取决于目标设备的系统版本与硬件条件，需要按机型清单确认，未列入清单的机型不承诺兼容；遥控器按键的映射规则按目标机型的标准执行，如有定制按键需求需另行评估。