# Apple TV

Device MCP で tvOS 27 の Apple TV シミュレータを起動、ミラーリング、操作できます。キーボードが Siri Remote になり、AI エージェントも同じ MCP ツールで tvOS アプリをテストできます。

Device MCP は、Apple TV シミュレータを iPhone のシミュレータと同じようにミラーリングして操作できます。同じサイドバーに並び、専用のフレームに表示され、AI エージェントも同じ MCP ツールを使えます。Apple TV にはタッチスクリーンがないため、Device MCP はあなたとエージェントに、代わりに Siri Remote を用意します。シミュレータには何もインストールしません。

## 1. 必要なもの
* Mac に **Xcode** と **tvOS 27** のシミュレータランタイムが必要です。ランタイムは **Xcode → Settings → Components** で追加します。
* tvOS 27 以降の Apple TV シミュレータに対応しています。4K または 1080p の Apple TV 4K です。
* 対応しているのは Apple TV シミュレータのみです。Device MCP は実機の Apple TV はミラーリングしません。

## 2. Apple TV シミュレータを起動する
1. サイドバー上部の **+** をクリックし、**New Simulator → Apple TV** とモデルを選びます。
2. **Start** をクリックします。Device MCP がシミュレータを起動し、準備ができ次第その画面を表示します。

Apple TV シミュレータの一覧表示、起動、シャットダウンは iPhone のシミュレータと同じで、サイドバーには TV のアイコンで表示されます。[iOS シミュレータ](ios-simulator.md#2-start-a-simulator)をご覧ください。

{% hint style="info" %}
Device MCP Free でミラーリングできるのは一度に 1 台で、Apple TV シミュレータも 1 台として数えます。Device MCP Pro なら台数の制限はありません。[ライセンス](../license.md)をご覧ください。
{% endhint %}

## 3. ミラーリングと操作
* **TV の姿で表示**：ミラーは Xcode の Device Hub と同じく、スタンドに載った細いベゼルの TV として描かれ、TV の解像度のままロスレスで表示されます（4K では 3840 × 2160、1080p では 1920 × 1080）。
* **マウスとトラックパッド**：ミラーをクリックすると **Select** です。ドラッグや 2 本指のスクロールで、コンテンツをスクロールするときと同じようにフォーカスが移動します。
* **キーボード**：TV と同じく、矢印キーでフォーカスを移動し、<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 ボタン（ホーム） | <kbd>⇧⌘H</kbd> |
| Appスイッチャー（TV ボタンを 2 回押す） | <kbd>⌃⇧⌘H</kbd> |
| Play/Pause（再生/一時停止） | <kbd>⇧⌘P</kbd> |
| Select（選択） | <kbd>Return</kbd>、またはミラーをクリック |

## 4. AI エージェントで使う
エージェントは、iPhone と同じ [MCP](../ai-agents/mcp.md) サーバーを通じて Apple TV シミュレータを使います。`list_elements` で画面を読み取り（フォーカスのある項目には印が付きます）、リモコンで操作します。

* `tap` は、1 回押すごとに画面を読み取りながら要素までフォーカスを移動し、そこで選択します。フォーカスがたどり着けない場合は、そう伝えます。
* `press_key` は矢印を押し（`count` で同じキーを繰り返します）、`press_button` は `select`、`menu`、`play_pause`、`home` を押します。
* `swipe` と `scroll` はフォーカスを移動し、`go_back` は Menu を押し、`type_text` は tvOS のキーボード画面に入力します。
* `start_simulator` は Apple TV シミュレータを起動または作成し、`launch_app` はアプリを開きます。

### ✅ プロンプトの例
* Apple TV 4K のシミュレータを起動して、ホーム画面のスクリーンショットを撮って。
* Apple TV シミュレータで私のアプリを開いて、ハチのドキュメンタリーを探して Up Next に追加して。
* Apple TV で設定を開いて、tvOS のバージョンを教えて。

## 5. iPhone との違い
* **タッチではなくフォーカス**：TV では、画面の一点をタップすることはできません。タップするとフォーカスがそこまで移動してから選択するため、少し時間がかかります。
* **回転、ロック、Siri、通知センター、Spotlight はなし**：tvOS にはこれらがありません。
* **Settings タブ、ステータスバーの整形、クリップボードはなし**：tvOS のシミュレータはこれらに対応していません。設定を変えるには、TV 自体の **設定** アプリを開きます。
* **Full で起動**：[Slim シミュレータ](ios-simulator.md#6-slim-simulators)は iOS と watchOS のみです。
