Govee (Editor Independente) (Versão prévia)
Integre dispositivos de luz inteligente govee em seus aplicativos com a API de Desenvolvedor do Govee. Controlar luzes, alterar cores, ajustar o brilho e definir temporizadores. Acesse o status do dispositivo em tempo real para desenvolvimento avançado de aplicativos.
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 | Richard Wilson |
| URL | https://www.richardawilson.com/ |
| richard.a.wilson@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Richard Wilson |
| Site | https://us.govee.com/ |
| Política de privacidade | https://us.govee.com/policies/privacy-policy |
| Categorias | Internet das Coisas |
Govee
Oferece integração perfeita com os sistemas de iluminação inteligente do Govee , permitindo que os usuários controlem e gerenciem sem esforço seus dispositivos. Ele permite uma ampla variedade de funcionalidades, incluindo ajuste de configurações de luz, alteração de cores, modificação do brilho e acesso ao status do dispositivo em tempo real.
A capacidade de automatizar e personalizar configurações de iluminação torna esse conector particularmente útil para melhorar o ambiente em casas inteligentes, criar cenas de iluminação dinâmica para várias ocasiões e integrar a iluminação inteligente em sistemas de automação residencial mais amplos. Ele oferece uma maneira conveniente e intuitiva para os usuários personalizarem sua experiência de iluminação e aproveitarem totalmente os recursos da tecnologia de iluminação inteligente da Govee.
Editor: Richard Wilson
Pré-requisitos
Antes de usar o conector do Govee, você deve obter uma Chave de API de Desenvolvedor do Govee. Siga estas etapas para adquirir a chave:
Obtendo uma chave de API de Desenvolvedor do Govee
Baixe o aplicativo Govee Home:
- Para iOS: Govee Home na App Store
- Para Android: Govee Home no Google Play
Acesse seu perfil:
- Abra o Aplicativo Govee Home e navegue até a página "Meu Perfil" tocando no ícone de perfil (👤).
Vá para Configurações:
- Clique no ícone de configurações (⚙️) localizado no canto superior direito para acessar o menu Configurações.
Aplique-se à chave de API:
- Selecione "Aplicar à Chave de API" no menu Configurações.
Formulário de aplicativo completo:
- Preencha os campos necessários para 'Nome' e 'Motivo do aplicativo'.
- Os motivos de exemplo incluem automação residencial, integração de terceiros ou fins educacionais.
- Preencha os campos necessários para 'Nome' e 'Motivo do aplicativo'.
Concordar com os Termos de Serviço:
- Leia cuidadosamente os Termos de Serviço da API de Desenvolvedor do Govee. Depois de entender os termos, marque a caixa para indicar sua aceitação.
Enviar aplicativo:
- Clique em 'Enviar' para enviar seu aplicativo para uma chave de API. Depois de aprovado, você receberá sua Chave de API do Govee, que é necessária para usar esse conector.
Lembre-se de que o processo de aprovação chave da API pode levar algum tempo, e a aprovação fica a critério de Govee. Verifique se seu aplicativo inclui um motivo válido e claro para solicitar a chave de API para aumentar a probabilidade de aprovação.
Operações com suporte
1. Executar comando no dispositivo
Essa operação permite que você envie vários comandos para controlar seu dispositivo Govee.
-
Propriedades de entrada:
- Endereço MAC do dispositivo: O endereço MAC exclusivo do dispositivo Govee a ser controlado.
- Modelo de dispositivo: O número do modelo do dispositivo Govee.
-
Detalhes do comando: Um objeto que contém o comando a ser executado. Ele inclui:
- Nome: O nome do comando (por exemplo, 'turn', 'brightness', 'color', 'colorTem').
- Parâmetros adicionais (com base no comando):
- Ativar: (Opcional) 'ativado' ou 'desativado' - usado quando o comando é 'turn'.
- Brilho: (Opcional) Valor numérico (0-100) – usado quando o comando é "brilho".
- Cor: (Opcional) Objeto com valores 'r', 'g', 'b' - usados quando o comando é 'color'.
- Temperatura da Cor: (Opcional) Valor numérico para temperatura de cor – usado quando o comando é 'colorTem'.
2. Obter informações do dispositivo
Recupere informações sobre um dispositivo Govee específico ou todos os dispositivos associados à sua conta.
-
Propriedades de entrada:
- Endereço MAC do dispositivo: (Opcional) O endereço MAC do dispositivo Govee específico para o qual as informações estão sendo solicitadas. Se omitidas, as informações de todos os dispositivos serão retornadas.
- Modelo de Dispositivo: (Opcional) O modelo do dispositivo Govee. Se especificado junto com o endereço MAC, ele refina a consulta para esse dispositivo específico.
Documentação da API
Para obter informações detalhadas sobre a API do Desenvolvedor do Govee Lights, incluindo seus recursos, pontos de extremidade, parâmetros e respostas, consulte a Documentação oficial da API govee. A documentação fornece diretrizes e exemplos abrangentes para ajudá-lo a integrar e utilizar efetivamente a API em seus aplicativos e fluxos de trabalho.
Problemas e limitações conhecidos
Atualmente, não existem problemas ou limitações conhecidos. Sempre consulte esta seção para obter informações atualizadas.
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 de API do Govee | secureString | A Chave de API govee que pode ser solicitada dentro do aplicativo móvel Govee. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Executar comando no dispositivo |
Execute um comando específico em um dispositivo Govee. Esse ponto de extremidade permite controlar vários aspectos do dispositivo, como estado de energia, brilho, cor e temperatura da cor. Forneça o endereço MAC e o modelo do dispositivo, juntamente com os detalhes do comando. Os comandos com suporte incluem 'turn' para controle de energia, 'brilho' para ajustar níveis de brilho, 'cor' para definir valores de cor RGB e 'colorTem' para ajustar a temperatura da cor. |
| Obter informações do dispositivo |
Acesse informações detalhadas sobre seus dispositivos Govee. Esse ponto de extremidade recupera dados de um dispositivo específico quando fornecidos com seu endereço MAC e modelo. Se nenhum dispositivo específico for especificado, o ponto de extremidade retornará informações para todos os dispositivos associados à sua conta. A resposta inclui detalhes do dispositivo, como o nome do dispositivo, controlabilidade, capacidade de recuperação, comandos com suporte e propriedades adicionais. Isso é útil para entender os recursos e a configuração atual de seus dispositivos Govee. |
Executar comando no dispositivo
Execute um comando específico em um dispositivo Govee. Esse ponto de extremidade permite controlar vários aspectos do dispositivo, como estado de energia, brilho, cor e temperatura da cor. Forneça o endereço MAC e o modelo do dispositivo, juntamente com os detalhes do comando. Os comandos com suporte incluem 'turn' para controle de energia, 'brilho' para ajustar níveis de brilho, 'cor' para definir valores de cor RGB e 'colorTem' para ajustar a temperatura da cor.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Endereço MAC do dispositivo
|
device | True | string |
O endereço MAC exclusivo do dispositivo Govee. Esse identificador é usado para especificar qual dispositivo você deseja controlar. |
|
Modelo do dispositivo
|
model | True | string |
O número do modelo do dispositivo Govee. Essas informações ajudam a identificar os recursos e funcionalidades específicos disponíveis para o dispositivo. |
|
Nome do Comando
|
name | True | string |
O comando a ser executado no dispositivo. Esse objeto inclui o nome do comando (por exemplo, 'turn', 'brightness', 'color', 'colorTem') e seu valor associado. O nome do comando determina o tipo de ação a ser executada no dispositivo. |
|
Volta
|
turn | string |
Esse parâmetro é usado para ativar ou desativar o dispositivo. Use isso somente quando o comando 'turn' estiver selecionado. Os valores válidos estão "ativados" ou "desativados". |
|
|
Brilho
|
brightness | integer |
O nível de brilho a ser definido para o dispositivo. Use esse parâmetro somente quando o comando "brilho" for selecionado. Insira um valor entre 0 (brilho mínimo) e 100 (brilho máximo). |
|
|
Cor - Vermelho
|
r | integer |
Esse parâmetro representa o componente vermelho do valor de cor RGB para o dispositivo. Ele faz parte do comando 'color'. Especifique um valor inteiro que varia de 0 a 255, em que 0 significa que nenhum vermelho e 255 representa a intensidade máxima de vermelho. |
|
|
Cor – Verde
|
g | integer |
Esse parâmetro define o componente verde do valor de cor RGB para o dispositivo. Ele é usado em conjunto com o comando 'color'. Forneça um valor inteiro entre 0 e 255, com 0 indicando que não há verde e 255 significando a maior intensidade de verde. |
|
|
Cor – Azul
|
b | integer |
O componente azul do valor de cor RGB a ser definido no dispositivo. Esse parâmetro faz parte do comando 'color'. O valor deve ser um inteiro que varia de 0 a 255, onde 0 é a ausência de azul e 255 indica o azul mais brilhante. |
|
|
Temperatura da Cor
|
colorTem | integer |
O valor de temperatura da cor a ser definido para o dispositivo. Use esse parâmetro somente quando o comando 'colorTem' estiver selecionado. Insira o valor da temperatura da cor conforme exigido pelo seu dispositivo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Código de status
|
code | integer |
O código de status HTTP da resposta |
|
Message
|
message | string |
Uma mensagem que descreve o resultado da operação |
|
dados
|
data | object |
Os dados retornados com a resposta. |
Obter informações do dispositivo
Acesse informações detalhadas sobre seus dispositivos Govee. Esse ponto de extremidade recupera dados de um dispositivo específico quando fornecidos com seu endereço MAC e modelo. Se nenhum dispositivo específico for especificado, o ponto de extremidade retornará informações para todos os dispositivos associados à sua conta. A resposta inclui detalhes do dispositivo, como o nome do dispositivo, controlabilidade, capacidade de recuperação, comandos com suporte e propriedades adicionais. Isso é útil para entender os recursos e a configuração atual de seus dispositivos Govee.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Endereço MAC do dispositivo
|
device | string |
Um parâmetro opcional que representa o endereço MAC do dispositivo Govee para o qual as informações estão sendo solicitadas. Se fornecida, a API retornará detalhes especificamente para este dispositivo. Deixe esse parâmetro vazio para recuperar informações para todos os dispositivos associados à conta. |
|
|
Modelo do dispositivo
|
model | string |
Um parâmetro opcional que indica o modelo do dispositivo Govee. Se especificado, a API retornará informações para dispositivos correspondentes a esse modelo. Esse parâmetro pode ser usado em conjunto com o Endereço MAC do Dispositivo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dispositivos
|
data.devices | array of object |
Uma lista de dispositivos associados à conta. Se um dispositivo específico for solicitado, a lista conterá apenas um dispositivo. |
|
Endereço MAC do dispositivo
|
data.devices.device | string |
O endereço MAC exclusivo do dispositivo |
|
Modelo do dispositivo
|
data.devices.model | string |
O número do modelo do dispositivo |
|
Nome do dispositivo
|
data.devices.deviceName | string |
O nome do dispositivo |
|
Controlável
|
data.devices.controllable | boolean |
Indica se o dispositivo é controlável |
|
Mínimo
|
data.devices.properties.colorTem.range.min | integer |
Valor mínimo de temperatura da cor |
|
Máximo
|
data.devices.properties.colorTem.range.max | integer |
Valor máximo de temperatura da cor |
|
Recuperável
|
data.devices.retrievable | boolean |
Indica se o dispositivo é recuperável |
|
Comandos com suporte
|
data.devices.supportCmds | array of string |
Comandos com suporte para o dispositivo |
|
Message
|
message | string |
Uma mensagem que descreve o resultado da operação |
|
Código de status
|
code | integer |
O código de status HTTP da resposta |