用途:为 tvOS 开发提供判断依据,而非基础语法教学。重点是焦点管理、遥控器手势与电视端 UI 的取舍决策。
主要能力:提供焦点管理策略(线性列表/网格用系统默认、多焦点区块用 .focusSection()、初次聚焦用 @FocusState 配合 .onAppear、条件逻辑用 .prefersDefaultFocus());自定义焦点效果决策(标准卡片用 .buttonStyle(.card),轻微高亮用 .isFocused 环境值,复杂视差仅用于主视觉内容);Top Shelf 内容类型选择(个性化用 Carousel .actions、发现类用 Sectioned、单向用单条 Carousel、未登录用促销内容加引导)。
使用要点:焦点切换动画应控制在 200ms 以内;不要用 .focusable() 却不给视觉反馈;不要手动管理索引重建 Focus Engine;不要用 Siri Remote 不支持的捏合/旋转手势;播放等界面必须处理 .onExitCommand 退出。UI 尺寸建议按钮/卡片不小于 200×80 pt、海报卡 300×450 pt、正文字号至少 title3、边距 60 pt。Top Shelf 需提供 1x/2x 图片,未登录也应有内容。
限制:资料未提供安装方式、价格、平台版本要求及实际效果数据。