> ## 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.

# Samsung Smart TV

> Controle Samsung Smart TVs (Tizen 2016+) pelo Portal

# Samsung Smart TV

Controle **Samsung Smart TVs** com sistema Tizen (modelos 2016 e superiores) diretamente pelo Portal.

## Requisitos

* TV Samsung Tizen 2016+ (modelos com WebSocket habilitado).
* TV e edge home na mesma rede local (LAN).
* Recomendado: MAC address da TV cadastrado para permitir Wake-on-LAN.

<Note>
  Modelos H e J (2014/2015) usam protocolo encriptado legado e não são suportados por essa integração.
</Note>

## Configurar

<Steps>
  <Step title="Adicione a integração">
    Vá em **Configurações → Integrações → Adicionar → Samsung Smart TV**.
  </Step>

  <Step title="Informe o IP da TV">
    Digite o endereço IP (ex: `192.168.1.100`). O MAC address é detectado automaticamente do endpoint público da TV — só preencha manualmente se a detecção falhar.
  </Step>

  <Step title="Aceite o pareamento">
    A TV exibirá uma solicitação. Confirme com o controle remoto — o Portal receberá o token de autenticação e o guardará.
  </Step>

  <Step title="Controle">
    Uma entidade `media_player` será criada para a TV.
  </Step>
</Steps>

## Funcionalidades

* **Ligar / Desligar** — desligamento via WebSocket (KEY\_POWER). Ligar exige Wake-on-LAN (MAC address).
* **Volume** — subir, baixar e mutar.
* **Canais** — próximo e anterior.
* **Fonte** — TV, HDMI 1-4.
* **Controles de mídia** — play, pause, stop, avançar, retroceder.

## Wake-on-LAN

Samsung Smart TVs precisam ser acordadas por magic packet (WoL) quando desligadas — o WebSocket fica offline em standby profundo. Para que o `turn_on` funcione:

1. Na TV, habilite **Configurações → Geral → Rede → Configurações Avançadas → Ligar por rede móvel** (ou equivalente, o nome varia por modelo).
2. Certifique-se que o MAC address está preenchido na configuração da integração.
3. O edge home deve estar na mesma L2 da TV — magic packets de broadcast não atravessam roteador.

## Dashboard

Use o card **Media Player** para controlar sua Samsung TV com interface completa.

<Tip>
  Crie automações para desligar a TV automaticamente após um horário ou ligar quando você chegar em casa (via presença).
</Tip>

## Limitações

* Volume absoluto (`volume_level`) não é exposto pela API pública — apenas volume relativo (up/down/mute).
* Seleção de app específico (Netflix, YouTube) não está disponível via WebSocket — use `KEY_SOURCE` para abrir o menu de fontes na TV.
* Modelos anteriores a 2016 (H/J series) usam protocolo encriptado e não são suportados.