> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cast

> Controle Chromecast, Google Nest e Cast Groups a partir do Portal

# Google Cast

A integração Google Cast conecta **Chromecast**, dispositivos **Google Home / Nest** e **Cast Groups** ao Portal via o protocolo **CASTV2** na rede local, expondo cada aparelho como um `media_player`.

## Pre-requisitos

* Dispositivo Cast na mesma rede do edge
* IP ou hostname do dispositivo (recomendado reservar no DHCP)
* Porta CASTV2 (padrão `8009`)

## Configurar

<Steps>
  <Step title="Adicione a integração">
    Va em **Configurações → Integrações → Adicionar → Google Cast**.
  </Step>

  <Step title="Informe o dispositivo">
    Preencha host e porta (`8009` na maioria dos casos).
  </Step>

  <Step title="Confirme a detecção">
    O probe retorna `friendlyName`, `modelName` e `uuid`, criando um `media_player` para o aparelho ou grupo.
  </Step>
</Steps>

## Recursos

* **Play / Pause / Stop** e navegação de mídia
* **Controle de volume** e mute
* **Lista de sources** e status atual (aplicativo em execução, música tocando)
* Suporte a **Cast Groups** — vários dispositivos tocando em sincronia

## Como Funciona

O `unique_id` da entrada é o `uuid` do dispositivo — trocar o IP mantém a integração vinculada ao mesmo Cast.

<Info>
  Cast Groups aparecem como um `media_player` só, controlando todos os membros do grupo em sincronia.
</Info>