# Apple TV

Starte, spiegle und steuere Apple TV-Simulatoren mit tvOS 27 in Device MCP, mit einer Siri Remote auf deiner Tastatur, und lass deinen KI-Agenten deine tvOS-App mit denselben MCP-Tools testen.

Device MCP spiegelt und steuert Apple TV-Simulatoren genauso wie einen iPhone-Simulator: in derselben Seitenleiste, im eigenen Rahmen und mit denselben MCP-Tools für deinen KI-Agenten. Ein Apple TV hat keinen Touchscreen, deshalb gibt Device MCP dir und deinem Agenten stattdessen seine Siri Remote. Im Simulator wird nichts installiert.

## 1. Voraussetzungen
* **Xcode** auf deinem Mac, mit einer **tvOS 27**-Simulator-Runtime. Du fügst sie unter **Xcode → Settings → Components** hinzu.
* Apple TV-Simulatoren mit tvOS 27 oder neuer: Apple TV 4K, in 4K oder in 1080p.
* Nur Apple TV-Simulatoren. Ein echtes Apple TV spiegelt Device MCP nicht.

## 2. Einen Apple TV-Simulator starten
1. Klicke oben in der Seitenleiste auf **+** und wähle **New Simulator → Apple TV** und ein Modell.
2. Klicke auf **Start**. Device MCP startet den Simulator und zeigt seinen Bildschirm, sobald er hochgefahren ist.

Apple TV-Simulatoren werden wie iPhone-Simulatoren aufgelistet, gestartet und heruntergefahren, mit einem TV-Symbol in der Seitenleiste. Siehe [iOS-Simulator](ios-simulator.md#2-start-a-simulator).

{% hint style="info" %}
Device MCP Free spiegelt ein Gerät gleichzeitig, und ein Apple TV-Simulator zählt als eines. Device MCP Pro spiegelt beliebig viele. Siehe [Lizenz](../license.md).
{% endhint %}

## 3. Spiegeln und steuern
* **Im Fernseher, auf dem es läuft**: Die Spiegelung sieht aus wie im Device Hub von Xcode, mit schmalem Rahmen auf einem Standfuß, verlustfrei in der Auflösung des Fernsehers (3840 × 2160 bei 4K, 1920 × 1080 bei 1080p).
* **Maus und Trackpad**: Ein Klick auf die Spiegelung ist **Select**. Ziehen oder Scrollen mit zwei Fingern bewegt den Fokus, so wie der Inhalt scrollen würde.
* **Tastatur**: Die Pfeiltasten bewegen den Fokus, <kbd>Return</kbd> ist **Select** und <kbd>Esc</kbd> ist **Menu**, wie auf einem Fernseher.
* **Tasten der Fernbedienung**: In der Symbolleiste findest du **Menu** (zurück), **Home** (die TV-Taste) und **App Switcher**. Das Menü **Device** ergänzt **Select**, **Play/Pause** und die Pfeile. Das Kontrollzentrum findest du im Menü **…**.
* **Bildschirmfotos und Aufnahmen**: siehe [Bildschirmfotos & Aufnahmen](../basic-features/screenshots-and-recording.md).

| Fernbedienung | Auf deinem Mac |
| --- | --- |
| Menu (zurück) | <kbd>⌘[</kbd> oder <kbd>Esc</kbd> |
| TV-Taste (Home) | <kbd>⇧⌘H</kbd> |
| App-Umschalter (TV-Taste zweimal drücken) | <kbd>⌃⇧⌘H</kbd> |
| Play/Pause | <kbd>⇧⌘P</kbd> |
| Select | <kbd>Return</kbd> oder ein Klick auf die Spiegelung |

## 4. Mit einem KI-Agenten
Dein Agent nutzt einen Apple TV-Simulator über denselben [MCP](../ai-agents/mcp.md)-Server wie ein iPhone. Er liest den Bildschirm mit `list_elements`, das markiert, welches Element den Fokus hat, und steuert ihn mit der Fernbedienung:

* `tap` bewegt den Fokus Tastendruck für Tastendruck zu einem Element, liest nach jedem Druck den Bildschirm und wählt das Element dann aus. Kommt der Fokus nicht dorthin, sagt `tap` das.
* `press_key` drückt die Pfeiltasten (`count` wiederholt einen Druck), und `press_button` drückt `select`, `menu`, `play_pause` und `home`.
* `swipe` und `scroll` bewegen den Fokus, `go_back` drückt Menu, und `type_text` tippt in den Tastaturbildschirm von tvOS.
* `start_simulator` startet oder erstellt einen Apple TV-Simulator, und `launch_app` öffnet deine App.

### ✅ Beispiel-Prompts
* Starte einen Apple TV 4K-Simulator und mach ein Bildschirmfoto vom Home-Bildschirm.
* Öffne meine App auf dem Apple TV-Simulator, such die Doku über Bienen und füge sie zu Up Next hinzu.
* Öffne auf dem Apple TV die Einstellungen und sag mir die tvOS-Version.

## 5. Unterschiede zu einem iPhone
* **Fokus statt Berührung**: Auf einem Fernseher tippt man nicht auf einen Punkt. Ein Tippen bewegt den Fokus dorthin und wählt aus, deshalb dauert es einen Moment länger.
* **Kein Drehen, Sperren, Siri, keine Mitteilungszentrale und kein Spotlight**: tvOS hat das alles nicht.
* **Kein Tab Settings, keine saubere Statusleiste, keine Zwischenablage**: Der tvOS-Simulator unterstützt sie nicht. Um eine Einstellung zu ändern, öffne die App **Einstellungen** des Fernsehers selbst.
* **Startet vollständig**: [Schlanke Simulatoren](ios-simulator.md#6-slim-simulators) gibt es nur für iOS und watchOS.
