# Apple TV

Lancez, recopiez et contrôlez des simulateurs d'Apple TV sous tvOS 27 dans Device MCP, avec une Siri Remote sur votre clavier, et laissez votre agent IA tester votre app tvOS avec les mêmes outils MCP.

Device MCP recopie et contrôle les simulateurs d'Apple TV comme un simulateur d'iPhone : dans la même barre latérale, dans leur propre cadre, et avec les mêmes outils MCP pour votre agent IA. Une Apple TV n'a pas d'écran tactile : Device MCP vous donne donc, à vous comme à votre agent, sa Siri Remote. Rien n'est installé dans le simulateur.

## 1. Prérequis
* **Xcode** sur votre Mac, avec un runtime de simulateur **tvOS 27**. Ajoutez-en un dans **Xcode → Settings → Components**.
* Des simulateurs d'Apple TV sous tvOS 27 ou version ultérieure : Apple TV 4K, en 4K ou en 1080p.
* Uniquement des simulateurs d'Apple TV. Device MCP ne recopie pas une vraie Apple TV.

## 2. Lancer un simulateur d'Apple TV
1. Cliquez sur **+** en haut de la barre latérale, puis choisissez **New Simulator → Apple TV** et un modèle.
2. Cliquez sur **Start**. Device MCP démarre le simulateur et affiche son écran dès qu'il est prêt.

Les simulateurs d'Apple TV sont listés, démarrés et éteints comme les simulateurs iPhone, avec une icône de téléviseur dans la barre latérale. Consultez [Simulateur iOS](ios-simulator.md#2-start-a-simulator).

{% hint style="info" %}
Device MCP Free recopie un appareil à la fois, et un simulateur d'Apple TV compte pour un. Device MCP Pro en recopie autant que vous voulez. Consultez [Licence](../license.md).
{% endhint %}

## 3. Recopier et contrôler
* **Sur son téléviseur** : la recopie est dessinée comme dans le Device Hub de Xcode, une fine bordure sur un pied, sans perte à la résolution du téléviseur (3840 × 2160 en 4K, 1920 × 1080 en 1080p).
* **Souris et trackpad** : un clic sur la recopie équivaut à **Select**. Faire glisser ou faire défiler à deux doigts déplace le focus, dans le sens où le contenu défilerait.
* **Clavier** : les touches fléchées déplacent le focus, <kbd>Return</kbd> correspond à **Select** et <kbd>Esc</kbd> à **Menu**, comme sur un téléviseur.
* **Boutons de la télécommande** : la barre d'outils comporte **Menu** (retour), **Home** (le bouton TV) et **App Switcher**. Le menu **Device** ajoute **Select**, **Play/Pause** et les flèches. Le centre de contrôle se trouve dans le menu **…**.
* **Captures d'écran et enregistrement** : consultez [Captures d'écran et enregistrement](../basic-features/screenshots-and-recording.md).

| Télécommande | Sur votre Mac |
| --- | --- |
| Menu (retour) | <kbd>⌘[</kbd> ou <kbd>Esc</kbd> |
| Bouton TV (Home) | <kbd>⇧⌘H</kbd> |
| Sélecteur d'apps (bouton TV pressé deux fois) | <kbd>⌃⇧⌘H</kbd> |
| Play/Pause | <kbd>⇧⌘P</kbd> |
| Select | <kbd>Return</kbd>, ou un clic sur la recopie |

## 4. Avec un agent IA
Votre agent utilise un simulateur d'Apple TV via le même serveur [MCP](../ai-agents/mcp.md) qu'un iPhone. Il lit l'écran avec `list_elements`, qui signale l'élément qui a le focus, et le pilote avec la télécommande :

* `tap` déplace le focus jusqu'à un élément, une pression à la fois, en relisant l'écran après chacune, puis le sélectionne. Il le signale quand le focus ne peut pas y arriver.
* `press_key` appuie sur les flèches (`count` en répète une), et `press_button` appuie sur `select`, `menu`, `play_pause` et `home`.
* `swipe` et `scroll` déplacent le focus, `go_back` appuie sur Menu, et `type_text` saisit du texte dans l'écran de clavier de tvOS.
* `start_simulator` démarre ou crée un simulateur d'Apple TV, et `launch_app` ouvre votre app.

### ✅ Exemples de prompts
* Lance un simulateur d'Apple TV 4K et fais une capture d'écran de l'écran d'accueil.
* Ouvre mon app sur le simulateur d'Apple TV, trouve le documentaire sur les abeilles et ajoute-le à Up Next.
* Sur l'Apple TV, ouvre Réglages et donne-moi la version de tvOS.

## 5. Différences avec un iPhone
* **Le focus, pas le toucher** : sur un téléviseur, on ne touche pas un point de l'écran. Un toucher y déplace le focus, puis sélectionne : cela prend donc un peu plus de temps.
* **Ni rotation, ni verrouillage, ni Siri, ni centre de notifications, ni Spotlight** : tvOS ne les a pas.
* **Ni onglet Settings, ni barre d'état épurée, ni presse-papiers** : le simulateur de tvOS ne les prend pas en charge. Pour modifier un réglage, ouvrez l'app **Réglages** du téléviseur lui-même.
* **Démarrage en version complète** : les [simulateurs allégés](ios-simulator.md#6-slim-simulators) ne concernent qu'iOS et watchOS.
