Referência: Serviços
Serviços são ações que podem ser chamadas para controlar entidades. Eles seguem o formatodominio.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.volume_set | Definir volume | volume_level (0-1) |
media_player.volume_mute | Mutar | is_volume_muted (true/false) |
media_player.select_source | Selecionar fonte | source |
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:- Dashboard — Interação com cards
- Automações — Ação “Chamar Serviço”
- Scripts — Ação “Chamar Serviço”
- API —
POST /v1/service/{domain}/{service} - Unicontrol AI — Comando em linguagem natural