React Native 电视端 UI 最佳实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/amazonappdev-devices-agent-skills-rn-tv-ui-best-practices。
技能介绍
电视端和手机的差别不是「大屏版 RN」
用户在沙发上离屏约 10 英尺,只有九键遥控器:没有触控、没有手势,焦点沿方向轴移动,导航本质上是线性的。手机上能读的字号在电视上像没写;纯黑纯白在 HDR 上容易「 bloom」;动画往往承担焦点或方向信号,而不是装饰点击反馈。常见痛点包括:D-pad 焦点乱跳、泳道/抽屉/Tab 不符合平台习惯、搜索与登录在遥控器上难用,以及 Vega 与 react-native-tvos 运行时行为不一致。
技能如何帮你审查或搭建 UI
使用前先核对 Runtime:package.json 里是 react-native-tvos(tvOS + Android TV)还是 @amazon-devices/react-native-kepler(Vega);没有 TV 运行时或 Platform.isTV 语境时,这套规则不适用。Agent 会按主题选用参考文档,而不是通读全部:
- 焦点与导航:
navigation-and-focus.md - 布局模式:泳道、Hero、抽屉、模态、安全区与过渡动效(
layout-patterns.md) - 字体与对比:10 英尺可读性、HDR、环境光(
typography-and-color.md) - 输入:遥控器模型、
TextInput、搜索、语音与 QR 登录(input-handling.md) - Vega:跨运行时坑点与官方文档入口(
vega-specifics.md)
辅助工具 references/scripts/audit.js 可对 src 做 grep 式静态检查(可按 --only / --skip 选章节),零依赖,有命中时退出码为 1;它只能抓静态可检测模式,大量规则仍依赖判断与真机。
边界:哪些必须交给人眼
需要真实电视、观看距离才能确认的事项——overscan 裁切、环境光下的焦点环、HDR 对比、动效手感、10 英尺字号——Agent 不会假装已测,会在收尾时汇总各参考文件末尾 Hand off to the human reviewer 清单,作为待办而非「已通过」项。
使用场景
- 接手 Fire TV 客户端后,用 D-pad 在泳道与详情页间焦点回环异常,需要按参考逐项排查
- 新上架 Vega 包时发现部分 API 与 tvOS 文档不一致,要对照 vega-specifics 与 Amazon 官方说明
- 准备发版前对 `src` 跑 audit.js,先筛 focus/layout 章节的静态反模式再人工复测
- 要从零实现带 Hero、抽屉 Tab 和搜索框的首页,需要按 layout-patterns 与 input-handling 对齐遥控器交互
适合人员
- 维护 `react-native-tvos` 多平台包、每周要处理遥控器焦点回归的 RN 工程师
- 负责 Amazon Kepler/Vega 首发,要在 codegen 与原生边界上避坑的应用开发者
- 做电视端设计评审的 UX,需要把 10 英尺可读性与 HDR 对比写成可执行检查项
- 流媒体产品 QA,在真机上验证 overscan 与焦点环前需要 Agent 先过一遍代码静态项