Govee (Editora Independente) (Pré-visualização)
Integre dispositivos de luz inteligente Govee em seus aplicativos com a Govee Developer API. Controle luzes, altere cores, ajuste o brilho e defina temporizadores. Aceda ao estado do dispositivo em tempo real para o desenvolvimento avançado de aplicações.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Richard Wilson |
| Sítio Web | 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 inteligentes da Govee , permitindo que os usuários controlem e gerenciem seus dispositivos sem esforço. Ele permite uma ampla gama de funcionalidades, incluindo ajustar as configurações de luz, alterar cores, modificar o brilho e acessar o status do dispositivo em tempo real.
A capacidade de automatizar e personalizar configurações de iluminação torna este conector particularmente útil para melhorar o ambiente em casas inteligentes, criando cenas de iluminação dinâmicas para várias ocasiões e integrando 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.
Editora: Richard Wilson
Pré-requisitos
Antes de poder usar o conector Govee, você deve obter uma chave de API do desenvolvedor Govee. Siga estes passos para adquirir a chave:
Obtendo uma chave de API do desenvolvedor Govee
Baixe o aplicativo Govee Home:
- Para iOS: Govee Home na App Store
- Para Android: Govee Home no Google Play
Aceda ao seu perfil:
- Abra o Govee Home App 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.
Solicite a chave da API:
- Selecione 'Apply for API Key' no menu Configurações.
Preencha o Formulário de Candidatura:
- Preencha os campos obrigatórios para 'Nome' e 'Motivo da candidatura'.
- Exemplos de razões incluem automação residencial, integração de terceiros ou fins educacionais.
- Preencha os campos obrigatórios para 'Nome' e 'Motivo da candidatura'.
Concordo com os Termos de Serviço:
- Leia atentamente os Termos de Serviço da Govee Developer API. Depois de entender os termos, marque a caixa para indicar sua aceitação.
Submeter Candidatura:
- Clique em 'Submeter' para enviar o seu pedido de uma chave API. Uma vez aprovado, você receberá sua chave de API Govee, que é necessária para usar este conector.
Por favor, esteja ciente de que o processo de aprovação da chave da API pode levar algum tempo, e a aprovação fica a critério da Govee. Certifique-se de que seu aplicativo inclua um motivo válido e claro para solicitar a chave da API para aumentar a probabilidade de aprovação.
Operações suportadas
1. Execute o comando no dispositivo
Esta 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 do dispositivo: O número do modelo do dispositivo Govee.
-
Detalhes do comando: Um objeto que contém o comando a ser executado. Inclui:
- Designação: O nome do comando (por exemplo, 'turn', 'brilho', 'color', 'colorTem').
- Parâmetros adicionais (com base no comando):
- Turn: (Opcional) 'on' ou 'off' - 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' - usado quando o comando é 'color'.
- Temperatura de 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 são retornadas.
- Modelo do 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 Govee Lights Developer API, incluindo seus recursos, endpoints, parâmetros e respostas, consulte a documentação oficial da Govee API. A documentação fornece orientações abrangentes e exemplos para ajudá-lo a integrar e utilizar efetivamente a API em seus aplicativos e fluxos de trabalho.
Problemas conhecidos e limitações
Atualmente, não existem problemas ou limitações conhecidos. Consulte sempre esta secção para obter informações atualizadas.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 Govee | securestring | A chave de API Govee que pode ser solicitada dentro do aplicativo móvel Govee. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de 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 aspetos do dispositivo, como estado de energia, brilho, cor e temperatura de cor. Forneça o endereço MAC e o modelo do dispositivo, juntamente com os detalhes do comando. Os comandos suportados incluem 'turn' para controle de energia, 'brilho' para ajustar os níveis de brilho, 'cor' para definir valores de cor RGB e 'colorTem' para ajustar a temperatura da cor. |
| Obter informações do dispositivo |
Aceda a informações detalhadas sobre os seus dispositivos Govee. Este ponto de extremidade recupera dados para um dispositivo específico quando fornecido 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 suportados 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 aspetos do dispositivo, como estado de energia, brilho, cor e temperatura de cor. Forneça o endereço MAC e o modelo do dispositivo, juntamente com os detalhes do comando. Os comandos suportados incluem 'turn' para controle de energia, 'brilho' para ajustar os níveis de brilho, 'cor' para definir valores de cor RGB e 'colorTem' para ajustar a temperatura da cor.
Parâmetros
| Name | Chave | Necessá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 seu dispositivo Govee. Essas informações ajudam a identificar os recursos específicos e os recursos disponíveis para o dispositivo. |
|
Nome do comando
|
name | True | string |
O comando a ser executado no dispositivo. Este objeto inclui o nome do comando (por exemplo, 'turn', 'brightness', 'color', 'colorTem') e seu valor associado. O nome do comando dita o tipo de ação a ser executada no dispositivo. |
|
Virar
|
turn | string |
Este parâmetro é usado para ligar ou desligar o dispositivo. Use isso somente quando o comando 'turn' estiver selecionado. Os valores válidos são 'on' ou 'off'. |
|
|
Brilho
|
brightness | integer |
O nível de brilho a definir para o dispositivo. Use este parâmetro somente quando o comando 'brilho' estiver selecionado. Insira um valor entre 0 (brilho mínimo) e 100 (brilho máximo). |
|
|
Cor - Vermelho
|
r | integer |
Este parâmetro representa o componente vermelho do valor de cor RGB para o dispositivo. É uma parte do comando 'color'. Especifique um valor inteiro que varie de 0 a 255, onde 0 significa nenhum vermelho e 255 representa a intensidade máxima de vermelho. |
|
|
Cor - Verde
|
g | integer |
Este parâmetro define o componente verde do valor de cor RGB para o dispositivo. É usado em conjunto com o comando 'color'. Forneça um valor inteiro entre 0 e 255, com 0 indicando ausência de 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. Este parâmetro faz parte do comando 'color'. O valor deve ser um número inteiro que varia de 0 a 255, onde 0 é a ausência de azul e 255 denota o azul mais brilhante. |
|
|
Temperatura de cor
|
colorTem | integer |
O valor da temperatura de cor a ser definido para o dispositivo. Use este parâmetro somente quando o comando 'colorTem' estiver selecionado. Insira o valor da temperatura de cor conforme exigido pelo seu dispositivo. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Código de estado
|
code | integer |
O código de status HTTP da resposta |
|
Message
|
message | string |
Uma mensagem descrevendo o resultado da operação |
|
dados
|
data | object |
Os dados retornaram com a resposta. |
Obter informações do dispositivo
Aceda a informações detalhadas sobre os seus dispositivos Govee. Este ponto de extremidade recupera dados para um dispositivo específico quando fornecido 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 suportados e propriedades adicionais. Isso é útil para entender os recursos e a configuração atual de seus dispositivos Govee.
Parâmetros
| Name | Chave | Necessá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 de 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 este modelo. Este parâmetro pode ser usado em conjunto com o endereço MAC do dispositivo. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Dispositivos
|
data.devices | array of object |
Uma lista de dispositivos associados à conta. Se for solicitado um dispositivo específico, 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 da temperatura de cor |
|
Maximum
|
data.devices.properties.colorTem.range.max | integer |
Valor máximo da temperatura de cor |
|
Recuperável
|
data.devices.retrievable | boolean |
Indica se o dispositivo é recuperável |
|
Comandos suportados
|
data.devices.supportCmds | array of string |
Comandos suportados para o dispositivo |
|
Message
|
message | string |
Uma mensagem descrevendo o resultado da operação |
|
Código de estado
|
code | integer |
O código de status HTTP da resposta |