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:

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

Tipos de Entidades Eventos