# Apple TV

Inicie, espelhe e controle simuladores da Apple TV com tvOS 27 no Device MCP, com um Siri Remote no seu teclado, e deixe seu agente de IA testar seu app para tvOS com as mesmas ferramentas MCP.

O Device MCP espelha e controla simuladores da Apple TV do mesmo jeito que um simulador de iPhone: na mesma barra lateral, na própria moldura e com as mesmas ferramentas MCP para seu agente de IA. A Apple TV não tem tela sensível ao toque, então o Device MCP dá a você e ao seu agente o Siri Remote dela. Nada é instalado no simulador.

## 1. Requisitos
* **Xcode** no seu Mac, com um runtime de simulador do **tvOS 27**. Adicione um em **Xcode → Settings → Components**.
* Simuladores da Apple TV com tvOS 27 ou posterior: Apple TV 4K, em 4K ou em 1080p.
* Apenas simuladores da Apple TV. O Device MCP não espelha uma Apple TV real.

## 2. Iniciar um simulador da Apple TV
1. Clique em **+** no topo da barra lateral e escolha **New Simulator → Apple TV** e um modelo.
2. Clique em **Start**. O Device MCP inicia o simulador e mostra a tela dele assim que ele estiver pronto.

Os simuladores da Apple TV são listados, iniciados e desligados como os de iPhone, com um ícone de TV na barra lateral. Veja [Simulador do iOS](ios-simulator.md#2-start-a-simulator).

{% hint style="info" %}
O Device MCP Free espelha um dispositivo por vez, e um simulador da Apple TV conta como um. O Device MCP Pro espelha quantos você quiser. Veja [Licença](../license.md).
{% endhint %}

## 3. Espelhar e controlar
* **Na própria TV**: o espelhamento aparece como no Device Hub do Xcode, uma TV de borda fina sobre um suporte, sem perdas e na resolução da TV (3840 × 2160 em 4K, 1920 × 1080 em 1080p).
* **Mouse e trackpad**: um clique no espelhamento é **Select**. Arrastar ou rolar com dois dedos move o foco, do jeito que o conteúdo rolaria.
* **Teclado**: as setas movem o foco, <kbd>Return</kbd> é **Select** e <kbd>Esc</kbd> é **Menu**, como em uma TV.
* **Botões do controle remoto**: a barra de ferramentas tem **Menu** (voltar), **Home** (o botão TV) e **App Switcher**. O menu **Device** acrescenta **Select**, **Play/Pause** e as setas. A Central de Controle fica no menu **…**.
* **Capturas e gravação**: veja [Capturas e gravação de tela](../basic-features/screenshots-and-recording.md).

| Controle remoto | No seu Mac |
| --- | --- |
| Menu (voltar) | <kbd>⌘[</kbd> ou <kbd>Esc</kbd> |
| Botão TV (Home) | <kbd>⇧⌘H</kbd> |
| App Switcher (botão TV pressionado duas vezes) | <kbd>⌃⇧⌘H</kbd> |
| Play/Pause | <kbd>⇧⌘P</kbd> |
| Select | <kbd>Return</kbd> ou um clique no espelhamento |

## 4. Com um agente de IA
Seu agente usa um simulador da Apple TV pelo mesmo servidor [MCP](../ai-agents/mcp.md) de um iPhone. Ele lê a tela com `list_elements`, que marca o item em foco, e navega por ela com o controle remoto:

* `tap` leva o foco até um elemento pressionando uma seta por vez, lendo a tela depois de cada uma, e então o seleciona. Ele avisa quando o foco não consegue chegar lá.
* `press_key` pressiona as setas (`count` repete uma), e `press_button` pressiona `select`, `menu`, `play_pause` e `home`.
* `swipe` e `scroll` movem o foco, `go_back` pressiona Menu e `type_text` digita na tela de teclado do tvOS.
* `start_simulator` inicia ou cria um simulador da Apple TV, e `launch_app` abre seu app.

### ✅ Exemplos de prompts
* Inicie um simulador da Apple TV 4K e faça uma captura de tela da Tela de Início.
* Abra meu app no simulador da Apple TV, encontre o documentário sobre abelhas e adicione-o ao Up Next.
* Na Apple TV, abra os Ajustes e me diga a versão do tvOS.

## 5. Diferenças em relação a um iPhone
* **Foco, não toque**: não dá para tocar em um ponto de uma TV. Um toque leva o foco até lá e seleciona, por isso demora um pouco mais.
* **Sem rotação, bloqueio, Siri, Central de Notificações nem Spotlight**: o tvOS não tem esses recursos.
* **Sem aba Settings, barra de status limpa nem área de transferência**: o simulador do tvOS não aceita esses recursos. Para mudar um ajuste, abra o app **Ajustes** da própria TV.
* **Inicia completo**: os [simuladores slim](ios-simulator.md#6-slim-simulators) são só para iOS e watchOS.
