Philips HUE (Editor Independente)
A Philips HUE permite controlar dispositivos domésticos inteligentes, como luzes, interruptores, plug-ins e mais construídos pela Philips.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| tomasz@poszytek.eu |
| Metadados do conector | |
|---|---|
| Publicador | Tomasz Poszytek |
| Site | https://www.philips-hue.com/ |
| Política de privacidade | https://www.philips-hue.com/en-us/support/legal/privacy-policy |
| Categorias | Internet das Coisas; Estilo de vida e entretenimento |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave do aplicativo HUE | secureString | A chave de API retornada após a execução de chamadas de autorização PUT e POST. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Excluir cena |
Excluir cena específica. |
| Executar dispositivo |
Execute um dispositivo específico. |
| Executar luz |
Execute o dispositivo com funcionalidades de raios. |
| Obter cena |
Obtenha detalhes de uma cena específica. |
| Obter cenas |
Obtenha uma lista de todas as cenas. As cenas são usadas para armazenar e recuperar as configurações de um grupo de luzes. |
| Obter dispositivo |
Obtenha detalhes de um dispositivo específico. |
| Obter dispositivos |
Obtenha a lista de todos os seus dispositivos. |
| Obter luz |
Obtenha detalhes de um dispositivo específico com recursos relâmpagos. |
| Obter luzes |
Obtenha uma lista de seus dispositivos com funcionalidades de raios. |
| Obter salas |
Obter lista de salas (grupos). |
Excluir cena
Excluir cena específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da cena
|
SceneId | True | string |
ID de uma cena a ser excluída. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
Cenas atualizadas. |
|
livrar
|
data.rid | string |
A ID exclusiva da cena excluída. |
|
rtype
|
data.rtype | string |
O tipo da cena excluída. |
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
Executar dispositivo
Execute um dispositivo específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do dispositivo
|
DeviceId | True | string |
ID de um dispositivo para atualizar metadados. |
|
Arquétipo
|
archetype | string |
Por padrão, o arquétipo dado pelo fabricante. |
|
|
Nome
|
name | string |
Nome legível humano de um recurso (máximo de 32 caracteres). |
|
|
Ação
|
action | string |
Digite "identificar" para disparar a identificação. A ponte executa ciclos de identificação de LED Zigbee por 5 segundos. As luzes executam um ciclo de respiração. Os sensores executam ciclos de identificação de LED por 15 segundos. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
Dispositivos atualizados. |
|
livrar
|
data.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.rtype | string |
O tipo do recurso referenciado. |
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
Executar luz
Execute o dispositivo com funcionalidades de raios.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do dispositivo
|
DeviceId | True | string |
ID de um dispositivo para atualizar as propriedades. |
|
Nome
|
name | string |
MinLength: 1 - maxLength: 32. Nome legível humano de um recurso. |
|
|
Por
|
on | boolean |
Estado ativado/desligado da luz on=true, off=false. |
|
|
Brilho
|
brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
|
Mirek
|
mirek | integer |
Mínimo: 153 – máximo: 500. Temperatura de cor em mirek ou nulo quando a cor clara não está no espectro ct. |
|
|
X
|
x | float |
Mínimo: 0 – máximo: 1. Posição X na gama de cores. |
|
|
S
|
y | float |
Mínimo: 0 – máximo: 1. Posição Y na gama de cores. |
|
|
Velocidade
|
speed | float |
Mínimo: 0 – máximo: 1. Velocidade da paleta dinâmica. A velocidade será válida para a paleta dinâmica se o status for dynamic_palette ou para o efeito correspondente listado no status. Em caso de status nenhum, a velocidade não é válida. |
|
|
Duração
|
duration | integer |
Máximo: 6000000. Duração de uma transição leve em ms. A precisão está em etapas de 100ms. |
|
|
Ação
|
action | string |
Uma das ações disponíveis a serem executadas em um dispositivo. Ou seja, "respire". |
|
|
X
|
x | float |
Mínimo: 0 – máximo: 1. Posição X na gama de cores. |
|
|
S
|
y | float |
Mínimo: 0 – máximo: 1. Posição Y na gama de cores. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of object |
dados |
|
livrar
|
data.rid | string |
livrar |
|
rtype
|
data.rtype | string |
rtype |
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
Obter cena
Obtenha detalhes de uma cena específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da cena
|
SceneId | True | string |
ID de uma cena para exibir detalhes. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
|
dados
|
data | array of object |
Dados. |
|
Ações
|
data.actions | array of object |
Lista de ações executadas na cena. |
|
X
|
data.actions.action.color.xy.x | float |
Mínimo: 0 – máximo: 1. Posição X na gama de cores. |
|
S
|
data.actions.action.color.xy.y | float |
Mínimo: 0 – máximo: 1. Posição Y na gama de cores. |
|
Brilho
|
data.actions.action.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Por
|
data.actions.action.on.on | boolean |
Estado ativado/desligado da luz on=true, off=false. |
|
Mirek
|
data.actions.action.color_temperature.mirek | integer |
Mínimo: 153 – máximo: 500. Temperatura de cor em mirek ou nulo quando a cor clara não está no espectro ct. |
|
livrar
|
data.actions.target.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.actions.target.rtype | string |
O tipo do recurso referenciado. |
|
livrar
|
data.group.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.group.rtype | string |
O tipo do recurso referenciado. |
|
ID
|
data.id | string |
Identificador exclusivo que representa uma instância de recurso específica. |
|
Id v1
|
data.id_v1 | string |
Identificador de recurso clip v1 (a ser usado na API v1). |
|
livrar
|
data.metadata.image.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.metadata.image.rtype | string |
O tipo do recurso referenciado. |
|
Nome
|
data.metadata.name | string |
Nome legível humano de um recurso. |
|
Cor
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
Mínimo: 0 – máximo: 1. Posição X na gama de cores. |
|
S
|
data.palette.color.color.xy.y | float |
Mínimo: 0 – máximo: 1. Posição Y na gama de cores. |
|
Brilho
|
data.palette.color.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Temperatura da cor
|
data.palette.color_temperature | array of object | |
|
Mirek
|
data.palette.color_temperature.color_temperature.mirek | integer |
Mínimo: 153 – máximo: 500. Temperatura de cor em mirek ou nulo quando a cor clara não está no espectro ct. |
|
Brilho
|
data.palette.color_temperature.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Escurecimento
|
data.palette.dimming | array of object | |
|
Brilho
|
data.palette.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Velocidade
|
data.speed | float |
Velocidade da paleta dinâmica para esta cena. |
|
Tipo
|
data.type | string |
Tipo dos recursos com suporte. |
Obter cenas
Obtenha uma lista de todas as cenas. As cenas são usadas para armazenar e recuperar as configurações de um grupo de luzes.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
|
dados
|
data | array of object |
Dados. |
|
Ações
|
data.actions | array of object |
Lista de ações executadas na cena. |
|
X
|
data.actions.action.color.xy.x | float |
Mínimo: 0 – máximo: 1. Posição X na gama de cores. |
|
S
|
data.actions.action.color.xy.y | float |
Mínimo: 0 – máximo: 1. Posição Y na gama de cores. |
|
Brilho
|
data.actions.action.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Por
|
data.actions.action.on.on | boolean |
Estado ativado/desligado da luz on=true, off=false. |
|
Mirek
|
data.actions.action.color_temperature.mirek | integer |
Mínimo: 153 – máximo: 500. Temperatura de cor em mirek ou nulo quando a cor clara não está no espectro ct. |
|
livrar
|
data.actions.target.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.actions.target.rtype | string |
O tipo do recurso referenciado. |
|
livrar
|
data.group.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.group.rtype | string |
O tipo do recurso referenciado. |
|
ID
|
data.id | string |
Identificador exclusivo que representa uma instância de recurso específica. |
|
Id v1
|
data.id_v1 | string |
Identificador de recurso clip v1 (a ser usado na API v1). |
|
livrar
|
data.metadata.image.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.metadata.image.rtype | string |
O tipo do recurso referenciado. |
|
Nome
|
data.metadata.name | string |
Nome legível humano de um recurso. |
|
Cor
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
Mínimo: 0 – máximo: 1. Posição X na gama de cores. |
|
S
|
data.palette.color.color.xy.y | float |
Mínimo: 0 – máximo: 1. Posição Y na gama de cores. |
|
Brilho
|
data.palette.color.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Temperatura da cor
|
data.palette.color_temperature | array of object | |
|
Mirek
|
data.palette.color_temperature.color_temperature.mirek | integer |
Mínimo: 153 – máximo: 500. Temperatura de cor em mirek ou nulo quando a cor clara não está no espectro ct. |
|
Brilho
|
data.palette.color_temperature.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Escurecimento
|
data.palette.dimming | array of object | |
|
Brilho
|
data.palette.dimming.brightness | float |
Máximo: 100. Porcentagem de brilho. Gravar 0 altera-o para o menor brilho possível. |
|
Velocidade
|
data.speed | float |
Velocidade da paleta dinâmica para esta cena. |
|
Tipo
|
data.type | string |
Tipo dos recursos com suporte. |
Obter dispositivo
Obtenha detalhes de um dispositivo específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do dispositivo
|
DeviceId | True | string |
ID de um dispositivo para exibir detalhes. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
|
dados
|
data | array of object |
Dispositivos correspondentes a determinada ID. |
|
ID
|
data.id | string |
Identificador exclusivo que representa uma instância de recurso específica. |
|
Id v1
|
data.id_v1 | string |
Identificador de recurso clip v1 (a ser usado na API v1). |
|
Arquétipo
|
data.metadata.archetype | string |
Arquétipo padrão dado pelo fabricante. |
|
Nome
|
data.metadata.name | string |
Nome legível humano de um recurso. |
|
Certificado
|
data.product_data.certified | boolean |
Este dispositivo é certificado por HUE. |
|
Nome do fabricante
|
data.product_data.manufacturer_name | string |
Nome do fabricante do dispositivo. |
|
ID do modelo
|
data.product_data.model_id | string |
identificação exclusiva do modelo de dispositivo. |
|
Arquétipo do produto
|
data.product_data.product_archetype | string |
Arquétipo do produto. |
|
Nome do produto
|
data.product_data.product_name | string |
O nome do produto. |
|
Versão do software
|
data.product_data.software_version | string |
Versão de software do produto. |
|
Services
|
data.services | array of object |
Faz referência a todos os serviços agregando o controle e o estado dos filhos no grupo. |
|
livrar
|
data.services.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.services.rtype | string |
O tipo do recurso referenciado. |
|
Tipo
|
data.type | string |
Tipo do recurso com suporte. |
Obter dispositivos
Obtenha a lista de todos os seus dispositivos.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
|
dados
|
data | array of object |
Dispositivos de usuário. |
|
ID
|
data.id | string |
Identificador exclusivo que representa uma instância de recurso específica. |
|
Id v1
|
data.id_v1 | string |
Identificador de recurso clip v1 (a ser usado na API v1). |
|
Arquétipo
|
data.metadata.archetype | string |
Arquétipo padrão dado pelo fabricante. |
|
Nome
|
data.metadata.name | string |
Nome legível humano de um recurso. |
|
Certificado
|
data.product_data.certified | boolean |
Este dispositivo é certificado por HUE. |
|
Nome do fabricante
|
data.product_data.manufacturer_name | string |
Nome do fabricante do dispositivo. |
|
ID do modelo
|
data.product_data.model_id | string |
identificação exclusiva do modelo de dispositivo. |
|
Arquétipo do produto
|
data.product_data.product_archetype | string |
Arquétipo do produto. |
|
Nome do produto
|
data.product_data.product_name | string |
O nome do produto. |
|
Versão do software
|
data.product_data.software_version | string |
Versão de software do produto. |
|
Services
|
data.services | array of object |
Faz referência a todos os serviços agregando o controle e o estado dos filhos no grupo. |
|
livrar
|
data.services.rid | string |
A ID exclusiva do recurso referenciado. |
|
rtype
|
data.services.rtype | string |
O tipo do recurso referenciado. |
|
Tipo
|
data.type | string |
Tipo do recurso com suporte. |
Obter luz
Obtenha detalhes de um dispositivo específico com recursos relâmpagos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do dispositivo
|
DeviceId | True | string |
ID de um dispositivo para exibir detalhes. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
|
dados
|
data | array of object |
Luzes correspondentes à ID fornecida. |
|
Valores de ação
|
data.alert.action_values | array of string |
Lista de efeitos de alerta compatíveis com a luz. |
|
X azul
|
data.color.gamut.blue.x | float |
Posição X na gama de cores. |
|
Azul Y
|
data.color.gamut.blue.y | float |
Posição Y na gama de cores. |
|
Verde X
|
data.color.gamut.green.x | float |
Posição X na gama de cores. |
|
Verde Y
|
data.color.gamut.green.y | float |
Posição X na gama de cores. |
|
Vermelho X
|
data.color.gamut.red.x | float |
Posição X na gama de cores. |
|
Vermelho Y
|
data.color.gamut.red.y | float |
Posição X na gama de cores. |
|
Tipo de gama
|
data.color.gamut_type | string |
Os tipos de gama compatíveis com matiz: A - Gama de produtos somente cores philips primitivos, B - Gama limitada de primeiros produtos de cor Hue, C - Gama de cores mais avançadas de produtos de ambiente branco e cor hue, outros - Gama de cores de produtos não matiz. |
|
X
|
data.color.xy.x | float |
Posição X na gama de cores. |
|
S
|
data.color.xy.y | float |
Posição Y na gama de cores. |
|
Mirek
|
data.color_temperature.mirek | integer |
Temperatura de cor em mirek ou nulo quando a cor clara não está no espectro ct. |
|
Máximo de Mirek
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
A temperatura máxima da cor é compatível com essa luz. |
|
Mínimo de Mirek
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
A temperatura mínima da cor é compatível com essa luz. |
|
Mirek válido
|
data.color_temperature.mirek_valid | boolean |
Indicação se o valor apresentado no mirek é válido. |
|
Brilho
|
data.dimming.brightness | float |
Porcentagem de brilho. O valor não pode ser 0, gravar 0 altera-o para o menor brilho possível. |
|
Nível mínimo de esmaecimento
|
data.dimming.min_dim_level | float |
Porcentagem do lumen máximo que o dispositivo gera com brilho mínimo. |
|
Velocidade
|
data.dynamics.speed | float |
Velocidade da paleta ou efeito dinâmico. A velocidade será válida para a paleta dinâmica se o status for dynamic_palette ou para o efeito correspondente listado no status. Em caso de status nenhum, a velocidade não é válida. |
|
Velocidade válida
|
data.dynamics.speed_valid | boolean |
Indica se o valor apresentado em velocidade é válido. |
|
Situação
|
data.dynamics.status | string |
Status atual da lâmpada com dinâmica. |
|
Valores de status
|
data.dynamics.status_values | array of string |
Status em que uma lâmpada pode estar ao reproduzir a dinâmica. |
|
ID do recurso
|
data.id | string |
Identificador exclusivo que representa uma instância de recurso específica. |
|
Clip v1 resource id
|
data.id_v1 | string |
Identificador de recurso clip v1 (versão da API v1). |
|
Arquétipo
|
data.metadata.archetype | string |
Arquétipo claro. Preterido: use o arquétipo no nível do dispositivo. |
|
Nome fornecido pelo dispositivo
|
data.metadata.name | string |
Nome legível humano de um recurso. |
|
Mode
|
data.mode | string |
Um deles: normal ou streaming. |
|
Estado claro
|
data.on.on | boolean |
Estado ativado/desligado da luz: on=true, off=false. |
|
RID
|
data.owner.rid | string |
A ID exclusiva do recurso referenciado. |
|
Rtype
|
data.owner.rtype | string |
O tipo do recurso referenciado. |
|
Tipo
|
data.type | string |
Tipo dos recursos com suporte. |
Obter luzes
Obtenha uma lista de seus dispositivos com funcionalidades de raios.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
|
dados
|
data | array of object |
Luzes do usuário. |
|
Valores de ação
|
data.alert.action_values | array of string |
Lista de efeitos de alerta compatíveis com a luz. |
|
X azul
|
data.color.gamut.blue.x | float |
Posição X na gama de cores. |
|
Azul Y
|
data.color.gamut.blue.y | float |
Posição Y na gama de cores. |
|
Verde X
|
data.color.gamut.green.x | float |
Posição X na gama de cores. |
|
Verde Y
|
data.color.gamut.green.y | float |
Posição X na gama de cores. |
|
Vermelho X
|
data.color.gamut.red.x | float |
Posição X na gama de cores. |
|
Vermelho Y
|
data.color.gamut.red.y | float |
Posição X na gama de cores. |
|
Tipo de gama
|
data.color.gamut_type | string |
Os tipos de gama compatíveis com matiz: A - Gama de produtos somente cores philips primitivos, B - Gama limitada de primeiros produtos de cor Hue, C - Gama de cores mais avançadas de produtos de ambiente branco e cor hue, outros - Gama de cores de produtos não matiz. |
|
X
|
data.color.xy.x | float |
Posição X na gama de cores. |
|
S
|
data.color.xy.y | float |
Posição Y na gama de cores. |
|
Mirek
|
data.color_temperature.mirek | integer |
Temperatura de cor em mirek ou nulo quando a cor clara não está no espectro ct. |
|
Máximo de Mirek
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
A temperatura máxima da cor é compatível com essa luz. |
|
Mínimo de Mirek
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
A temperatura mínima da cor é compatível com essa luz. |
|
Mirek válido
|
data.color_temperature.mirek_valid | boolean |
Indicação se o valor apresentado no mirek é válido. |
|
Brilho
|
data.dimming.brightness | float |
Porcentagem de brilho. O valor não pode ser 0, gravar 0 altera-o para o menor brilho possível. |
|
Nível mínimo de esmaecimento
|
data.dimming.min_dim_level | float |
Porcentagem do lumen máximo que o dispositivo gera com brilho mínimo. |
|
Velocidade
|
data.dynamics.speed | float |
Velocidade da paleta ou efeito dinâmico. A velocidade será válida para a paleta dinâmica se o status for dynamic_palette ou para o efeito correspondente listado no status. Em caso de status nenhum, a velocidade não é válida. |
|
Velocidade válida
|
data.dynamics.speed_valid | boolean |
Indica se o valor apresentado em velocidade é válido. |
|
Situação
|
data.dynamics.status | string |
Status atual da lâmpada com dinâmica. |
|
Valores de status
|
data.dynamics.status_values | array of string |
Status em que uma lâmpada pode estar ao reproduzir a dinâmica. |
|
ID do recurso
|
data.id | string |
Identificador exclusivo que representa uma instância de recurso específica. |
|
Clip v1 resource id
|
data.id_v1 | string |
Identificador de recurso clip v1 (versão da API v1). |
|
Arquétipo
|
data.metadata.archetype | string |
Arquétipo claro. Preterido: use o arquétipo no nível do dispositivo. |
|
Nome fornecido pelo dispositivo
|
data.metadata.name | string |
Nome legível humano de um recurso. |
|
Mode
|
data.mode | string |
Um deles: normal ou streaming. |
|
Estado claro
|
data.on.on | boolean |
Estado ativado/desligado da luz: on=true, off=false. |
|
RID
|
data.owner.rid | string |
A ID exclusiva do recurso referenciado. |
|
Rtype
|
data.owner.rtype | string |
O tipo do recurso referenciado. |
|
Tipo
|
data.type | string |
Tipo dos recursos com suporte. |
Obter salas
Obter lista de salas (grupos).
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Erros
|
errors | array of object |
Erros que ocorreram durante a chamada. |
|
Descrição do erro
|
errors.description | string |
Uma explicação legível pelo ser humano específica para essa ocorrência do problema. |
|
dados
|
data | array of object |
Dados. |
|
Crianças
|
data.children | array of object |
Dispositivos a serem agrupadas pela Sala. Os seguintes filhos são permitidos: "dispositivo". |
|
livrar
|
data.children.rid | string |
A ID exclusiva da cena criada. |
|
rtype
|
data.children.rtype | string |
O tipo da cena criada. |
|
Serviços agrupados
|
data.grouped_services | array of object |
Referências a serviços de controle agregados. Preterido: use serviços. |
|
livrar
|
data.grouped_services.rid | string |
A ID exclusiva da cena criada. |
|
rtype
|
data.grouped_services.rtype | string |
O tipo da cena criada. |
|
ID
|
data.id | string |
Identificador exclusivo que representa uma instância de recurso específica. |
|
Id v1
|
data.id_v1 | string |
Identificador de recurso clip v1 (a ser usado na API v1). |
|
Arquétipo
|
data.metadata.archetype | string |
Arquétipo padrão dado pelo fabricante. |
|
Nome
|
data.metadata.name | string |
Nome legível humano de um recurso. |
|
Services
|
data.services | array of object |
Faz referência a todos os serviços agregando o controle e o estado dos filhos no grupo. A agregação é por tipo de serviço, ou seja, cada tipo de serviço que pode ser agrupado tem uma definição correspondente de tipo agrupado. Tipos com suporte: "light". |
|
livrar
|
data.services.rid | string |
A ID exclusiva da cena criada. |
|
rtype
|
data.services.rtype | string |
O tipo da cena criada. |
|
Tipo
|
data.type | string |
Tipo dos recursos com suporte. |