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

# Serviços

> Referência de serviços disponíveis para controlar entidades

# Referência: Serviços

Serviços são ações que podem ser chamadas para controlar entidades. Eles seguem o formato `dominio.servico`.

## Serviços por Domínio

### light

| Serviço          | Descrição       | Dados                               |
| ---------------- | --------------- | ----------------------------------- |
| `light.turn_on`  | Ligar luz       | brightness, color\_temp, rgb\_color |
| `light.turn_off` | Desligar luz    | -                                   |
| `light.toggle`   | Alternar estado | -                                   |

### switch

| Serviço           | Descrição            | Dados |
| ----------------- | -------------------- | ----- |
| `switch.turn_on`  | Ligar interruptor    | -     |
| `switch.turn_off` | Desligar interruptor | -     |
| `switch.toggle`   | Alternar estado      | -     |

### cover

| Serviço              | Descrição       | Dados            |
| -------------------- | --------------- | ---------------- |
| `cover.open`         | Abrir cortina   | -                |
| `cover.close`        | Fechar cortina  | -                |
| `cover.stop`         | Parar movimento | -                |
| `cover.set_position` | Definir posição | position (0-100) |

### climate

| Serviço                   | Descrição             | Dados                                         |
| ------------------------- | --------------------- | --------------------------------------------- |
| `climate.turn_on`         | Ligar climatizacao    | -                                             |
| `climate.turn_off`        | Desligar climatizacao | -                                             |
| `climate.set_temperature` | Definir temperatura   | temperature                                   |
| `climate.set_hvac_mode`   | Definir modo          | hvac\_mode (cool, heat, auto, dry, fan\_only) |
| `climate.set_fan_mode`    | Definir ventilador    | fan\_mode                                     |

### fan

| Serviço              | Descrição           | Dados                    |
| -------------------- | ------------------- | ------------------------ |
| `fan.turn_on`        | Ligar ventilador    | speed, percentage        |
| `fan.turn_off`       | Desligar ventilador | -                        |
| `fan.set_percentage` | Definir velocidade  | percentage (0-100)       |
| `fan.oscillate`      | Alternar oscilacao  | oscillating (true/false) |

### media\_player

| Serviço                       | Descrição                    | Dados                                    |
| ----------------------------- | ---------------------------- | ---------------------------------------- |
| `media_player.turn_on`        | Ligar                        | -                                        |
| `media_player.turn_off`       | Desligar                     | -                                        |
| `media_player.play`           | Reproduzir                   | -                                        |
| `media_player.pause`          | Pausar                       | -                                        |
| `media_player.stop`           | Parar                        | -                                        |
| `media_player.next_track`     | Próxima faixa/canal          | -                                        |
| `media_player.previous_track` | Faixa/canal anterior         | -                                        |
| `media_player.set_volume`     | Definir volume               | volume\_level (0-1)                      |
| `media_player.volume_up`      | Aumentar volume              | -                                        |
| `media_player.volume_down`    | Diminuir volume              | -                                        |
| `media_player.mute`           | Mutar                        | is\_volume\_muted (true/false)           |
| `media_player.select_source`  | Selecionar fonte             | source                                   |
| `media_player.channel_up`     | Canal +                      | -                                        |
| `media_player.channel_down`   | Canal −                      | -                                        |
| `media_player.play_media`     | Reproduzir mídia (deep-link) | media\_content\_type, media\_content\_id |

### lock

| Serviço       | Descrição  | Dados |
| ------------- | ---------- | ----- |
| `lock.lock`   | Trancar    | -     |
| `lock.unlock` | Destrancar | -     |

### select

| Serviço                | Descrição        | Dados  |
| ---------------------- | ---------------- | ------ |
| `select.select_option` | Selecionar opção | option |

### button

| Serviço        | Descrição        | Dados |
| -------------- | ---------------- | ----- |
| `button.press` | Pressionar botão | -     |

### script

| Serviço               | Descrição       | Dados      |
| --------------------- | --------------- | ---------- |
| `script.script.press` | Executar script | script\_id |

## Chamando Serviços

Serviços podem ser chamados de varias formas:

1. **Dashboard** — Interação com cards
2. **Automações** — Ação "Chamar Serviço"
3. **Scripts** — Ação "Chamar Serviço"
4. **API** — `POST /v1/service/{domain}/{service}`
5. **Unicontrol AI** — Comando em linguagem natural