# Apple TV

在 Device MCP 中启动、镜像和控制运行 tvOS 27 的 Apple TV 模拟器，用键盘充当 Siri Remote 遥控器，并让 AI Agent 用同一套 MCP 工具测试你的 tvOS App。

Device MCP 镜像和控制 Apple TV 模拟器的方式与 iPhone 模拟器相同：在同一个侧边栏里，显示在它自己的外框中，AI Agent 也使用同一套 MCP 工具。Apple TV 没有触摸屏，所以 Device MCP 改为给你和你的 Agent 一个 Siri Remote 遥控器。模拟器中无需安装任何东西。

## 1. 要求
* Mac 上需要安装 **Xcode**，并带有 **tvOS 27** 模拟器运行时。可在 **Xcode → Settings → Components** 中添加。
* 支持运行 tvOS 27 或更高版本的 Apple TV 模拟器：Apple TV 4K，可选 4K 或 1080p。
* 仅支持 Apple TV 模拟器。Device MCP 不能镜像 Apple TV 真机。

## 2. 启动 Apple TV 模拟器
1. 点击侧边栏顶部的 **+**，选择 **New Simulator → Apple TV** 和机型。
2. 点击 **Start**。Device MCP 会启动模拟器，并在启动完成后立即显示它的屏幕。

Apple TV 模拟器的列出、启动和关闭方式与 iPhone 模拟器相同，在侧边栏中显示为电视图标。参见 [iOS 模拟器](ios-simulator.md#2-start-a-simulator)。

{% hint style="info" %}
Device MCP Free 一次镜像一台设备，Apple TV 模拟器也算一台。Device MCP Pro 不限数量。参见[许可证](../license.md)。
{% endhint %}

## 3. 镜像与控制
* **电视外框**：镜像的样子与 Xcode 的 Device Hub 中一样，是一台立在底座上的窄边框电视，并以电视的分辨率无损呈现（4K 为 3840 × 2160，1080p 为 1920 × 1080）。
* **鼠标和触控板**：在镜像上点击即为 **Select**。拖动或双指滚动会像滚动内容一样移动焦点。
* **键盘**：方向键移动焦点，<kbd>Return</kbd> 即 **Select**，<kbd>Esc</kbd> 即 **Menu**，与在电视上一样。
* **遥控器按钮**：工具栏中有 **Menu**（返回）、**Home**（TV 按钮）和 **App Switcher**。**Device** 菜单还提供 **Select**、**Play/Pause** 和方向键。控制中心位于 **…** 菜单中。
* **截图与录屏**：参见[截图与录屏](../basic-features/screenshots-and-recording.md)。

| 遥控器 | 在 Mac 上 |
| --- | --- |
| Menu（返回） | <kbd>⌘[</kbd> 或 <kbd>Esc</kbd> |
| TV 按钮（Home） | <kbd>⇧⌘H</kbd> |
| App 切换器（连按两下 TV 按钮） | <kbd>⌃⇧⌘H</kbd> |
| 播放/暂停 | <kbd>⇧⌘P</kbd> |
| Select | <kbd>Return</kbd>，或点击镜像 |

## 4. 配合 AI Agent 使用
你的 Agent 通过与 iPhone 相同的 [MCP](../ai-agents/mcp.md) 服务器使用 Apple TV 模拟器。它用 `list_elements` 读取屏幕，结果中会标出获得焦点的项目，然后用遥控器来操作：

* `tap` 每次按一下方向键，把焦点逐步移向某个元素，每按一次都重新读取屏幕，到达后再选中它。焦点无法到达时，它会如实告知。
* `press_key` 按方向键（`count` 可重复按同一个键），`press_button` 按 `select`、`menu`、`play_pause` 和 `home`。
* `swipe` 和 `scroll` 移动焦点，`go_back` 按 Menu，`type_text` 在 tvOS 的键盘界面中输入。
* `start_simulator` 启动或新建 Apple TV 模拟器，`launch_app` 打开你的 App。

### ✅ 示例提示词
* 启动一个 Apple TV 4K 模拟器，截取主屏幕。
* 在 Apple TV 模拟器上打开我的 App，找到关于蜜蜂的纪录片，把它加入 Up Next。
* 在 Apple TV 上打开“设置”，告诉我 tvOS 的版本。

## 5. 与 iPhone 的区别
* **靠焦点，而不是触摸**：在电视上没法轻点某个位置。轻点会先把焦点移过去再选中，所以要稍久一些。
* **没有旋转、锁定、Siri、通知中心和聚焦搜索**：tvOS 没有这些。
* **没有 Settings 标签页、整洁状态栏和剪贴板**：tvOS 模拟器不支持这些。要更改设置，请打开电视自己的**设置** App。
* **以完整方式启动**：[精简模拟器](ios-simulator.md#6-slim-simulators)仅适用于 iOS 和 watchOS。
