用途:为 tvOS 应用提供设计与实现参考,重点解决无指针、无触摸屏、仅靠焦点导航与 Siri Remote 交互的客厅场景问题。
主要能力:
- 焦点式导航:每个可交互元素需有清晰焦点态;焦点移动需可预测;用 UIFocusGuide 桥接布局间隙;对焦点项应用视差效果(LSR 分层图片);焦点目标建议最小 250x150pt;每屏设默认焦点并保留焦点记忆;禁止焦点陷阱。
- Siri Remote:滑动移动焦点、点击选中;Menu 键始终返回;Play/Pause 控制播放;不要求复杂多指手势;支持 Siri 语音输入与听写;点击需即时反馈。
- 10 英尺 UI:正文最小 29pt,标题 48pt 以上;高对比度;文字精简;高分辨率图像(全屏 1920x1080 或 3840x2160);留足边距,内容置于安全区(边缘内缩 60pt);避免细字体与发丝线。
- Top Shelf:建议提供 TVTopShelfContentProvider(tvOS 14+),TVTopShelfProvider 已弃用;支持 inset banner 与 sectioned content 布局;条目需深链进入应用;提供高质量图像并保持内容更新。
- 媒体与播放:使用标准传输控件,建议 AVPlayerViewController;下滑显示信息层;触摸表面支持拖动进度;支持字幕与音轨切换、画中画;记忆播放位置;优雅处理中断。
- 标签栏:置于屏幕顶部,半透明覆盖内容;建议 3-7 个标签,每个需文字标签;记忆上次选中标签。
- 无障碍:每个交互元素需有意义的标签;提供提示;VoiceOver 焦点顺序需与视觉焦点顺序一致;响应减弱动态效果、粗体文字、增强对比度与动态字体。
使用方式:作为设计评审与实现对照的规则清单使用,代码示例中涉及 SwiftUI 的 @FocusState、.focused、.scaleEffect,UIKit 的 UIFontMetrics、UIAccessibility 等 API。
适用场景:构建 tvOS 应用、焦点导航界面、Siri Remote 输入处理、客厅观影体验、Top Shelf 内容与媒体播放界面。
限制:资料为公开设计准则,未提供收费、价格、平台支持范围或效果保证等信息;具体 API 可用性需以 Apple 官方文档为准。