mcpField
T
tvos

tvos

github.com/fusengine开发3447 次安装2 周前更新
代码仓库

关于 tvos

面向 Apple TV 应用开发的 tvOS 技能，涵盖焦点导航、媒体播放、遥控器交互和多用户支持，也说明 tvOS 26 的 Liquid Glass 行为及客厅界面设计要点。

主要功能

  1. 01焦点系统与视觉反馈
  2. 02tvOS 26 Liquid Glass 指引
  3. 03AVKit 媒体播放
  4. 04Siri Remote 手势
  5. 05多用户与控制器支持

适用场景

  1. 01开发 Apple TV 应用
  2. 02设计基于焦点的导航
  3. 03实现视频和音频播放
  4. 04支持遥控器与多用户交互

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fusengine/claude-plugins --skill tvos

安装后在 Claude Code 中输入/tvos确认已加载。

详细介绍

涵盖 Apple TV 客厅体验的 tvOS 专属开发：大屏导航的焦点系统、TV 上的 Liquid Glass 样式（tvOS 26）、AVKit 媒体播放、Siri Remote 手势处理、多用户支持，以及游戏控制器集成。

包含 tvOS 26 及更高版本的指导：系统会自动为 Liquid Glass 应用样式（按钮和图像在获得焦点时会采用该样式，不要手动添加），以及由焦点状态驱动的缩放效果。

最佳实践：确保 UI 元素在 10 英尺外清晰可读，提供明确的视觉焦点反馈，尽量减少导航层级，设计适合遥控器的手势，优先展示媒体内容，并支持切换用户。

tvOS 平台

面向 Apple TV 客厅体验的 tvOS 专属开发。

Agent 工作流（强制）

在进行任何实现之前，并行启动 3 个 Agent，每个使用一个带有 name 的 Agent 调用：

  1. fuse-ai-pilot:explore-codebase - 分析现有的 tvOS 模式
  2. fuse-ai-pilot:research-expert - 通过 Context7/Exa 验证最新的 tvOS 27 文档
  3. mcp__apple-docs__search_apple_docs - 检查 tvOS 模式

实现完成后，运行 fuse-ai-pilot:sniper 进行验证。

概述

适用场景
  • 构建 Apple TV 应用
  • 视频和音频流媒体
  • 基于焦点的导航
  • Siri Remote 交互
  • 多用户体验
  • 游戏控制器支持
为什么使用 tvOS 技能
功能优势
焦点系统大屏导航
Liquid Glass现代 TV 界面（tvOS 26）
媒体播放AVKit 集成
遥控器Siri Remote 手势

tvOS 26 功能

TV 上的 Liquid Glass

在 tvOS 中，Liquid Glass 会出现在导航和系统体验的各个部分；按钮和图像视图在获得焦点时会自动采用该样式（HIG https://developer.apple.com/design/human-interface-guidelines/materials）。不要手动添加 glassEffect，请使用标准样式和组件。

TabView {
    Tab("Home", systemImage: "house") { HomeView() }   // system tab bar gets glass
}

Button("Watch Now") { }
    .buttonStyle(.bordered)   // standard style: system handles the focused appearance

内容层叠加应使用标准材质（而非 glass）。

焦点系统
struct ContentView: View {
    @FocusState private var focused: Bool

    var body: some View {
        Button("Play") { }
            .focused($focused)
            .scaleEffect(focused ? 1.1 : 1.0)
    }
}

参考指南

需求参考资料
焦点、选择状态focus-system.md
AVKit、视频播放media-playback.md
Siri Remote、手势remote-control.md

最佳实践

  1. 较大的 UI 元素 - 控件默认尺寸为 66x66 pt，最小为 56x56 pt；正文默认字号为 29 pt，最小为 23 pt（HIG 无障碍功能）
  2. 焦点反馈 - 提供清晰的视觉指示（HIG 焦点）
  3. 简化导航 - 尽量减少层级
  4. 适配遥控器 - 支持 Siri Remote 手势
  5. 媒体优先 - 针对视频和音频进行优化
  6. 多用户 - 支持切换用户

评论

支持 Markdown