Govee (publicador independiente) (versión preliminar)
Integre los dispositivos de luz inteligente de Govee en sus aplicaciones con la API para desarrolladores de Govee. Controle las luces, cambie los colores, ajuste el brillo y establezca temporizadores. Acceda al estado del dispositivo en tiempo real para el desarrollo avanzado de aplicaciones.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Richard Wilson |
| URL | https://www.richardawilson.com/ |
| Correo Electrónico | richard.a.wilson@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Richard Wilson |
| Website | https://us.govee.com/ |
| Directiva de privacidad | https://us.govee.com/policies/privacy-policy |
| Categorías | Internet de las cosas |
Govee
Ofrece una integración perfecta con los sistemas de iluminación inteligente de Govee , lo que permite a los usuarios controlar y administrar sus dispositivos sin esfuerzo. Permite una amplia gama de funcionalidades, como ajustar la configuración de luz, cambiar los colores, modificar el brillo y acceder al estado del dispositivo en tiempo real.
La capacidad de automatizar y personalizar las configuraciones de iluminación hace que este conector sea especialmente útil para mejorar el ambiente en hogares inteligentes, crear escenas de iluminación dinámicas para varias ocasiones e integrar la iluminación inteligente en sistemas más amplios de automatización doméstica. Ofrece una manera cómoda e intuitiva para que los usuarios personalicen su experiencia de iluminación y aprovechen completamente las funcionalidades de la tecnología de iluminación inteligente de Govee.
Publicador: Richard Wilson
Prerrequisitos
Para poder usar el conector Govee, debe obtener una clave de API para desarrolladores de Govee. Siga estos pasos para adquirir la clave:
Obtención de una clave de API para desarrolladores de Govee
Descargue la aplicación principal govee:
- Para iOS: Inicio de Govee en app Store
- Para Android: Govee Home en Google Play
Acceda a su perfil:
- Abra la aplicación principal govee y vaya a la página "Mi perfil" pulsando el icono de perfil (👤).
Vaya a Configuración:
- Haga clic en el icono de configuración (⚙️) situado en la esquina superior derecha para acceder al menú Configuración.
Aplicar para la clave de API:
- Seleccione "Aplicar para clave de API" en el menú Configuración.
Formulario de aplicación completo:
- Rellene los campos obligatorios para "Name" y "Reason for application".
- Entre los motivos de ejemplo se incluyen la automatización doméstica, la integración de terceros o los propósitos educativos.
- Rellene los campos obligatorios para "Name" y "Reason for application".
Acepta los términos de servicio:
- Lea detenidamente los términos del servicio de la API para desarrolladores de Govee. Una vez que haya comprendido los términos, active la casilla para indicar su aceptación.
Enviar aplicación:
- Haga clic en "Enviar" para enviar la aplicación para obtener una clave de API. Una vez aprobada, recibirá la clave de API de Govee, que es necesaria para usar este conector.
Tenga en cuenta que el proceso de aprobación de la clave de API puede tardar algún tiempo y la aprobación es a discreción de Govee. Asegúrese de que la aplicación incluye un motivo válido y claro para solicitar la clave de API para aumentar la probabilidad de aprobación.
Operaciones admitidas
1. Ejecutar comando en el dispositivo
Esta operación le permite enviar varios comandos para controlar el dispositivo Govee.
-
Propiedades de entrada:
- Dirección MAC del dispositivo: Dirección MAC única del dispositivo Govee que se va a controlar.
- Modelo de dispositivo: Número de modelo del dispositivo Govee.
-
Detalles del comando: Objeto que contiene el comando que se va a ejecutar. Incluye:
- Nombre: Nombre del comando (por ejemplo, "turn", "brillo", "color", "colorTem").
- Parámetros adicionales (basados en el comando):
- Turn: (Opcional) 'on' o 'off': se usa cuando el comando es 'turn'.
- Brillo: (Opcional) Valor numérico (0-100): se usa cuando el comando es "brillo".
- Color: (Opcional) Object con los valores 'r', 'g', 'b', que se usan cuando el comando es 'color'.
- Temperatura de color: (Opcional) Valor numérico para la temperatura del color: se usa cuando el comando es "colorTem".
2. Obtener información del dispositivo
Recupera información sobre un dispositivo Govee específico o todos los dispositivos asociados a tu cuenta.
-
Propiedades de entrada:
- Dirección MAC del dispositivo: (opcional) Dirección MAC del dispositivo Govee específico para el que se solicita información. Si se omite, se devuelve información de todos los dispositivos.
- Modelo de dispositivo: (opcional) El modelo del dispositivo Govee. Si se especifica junto con la dirección MAC, refina la consulta a ese dispositivo específico.
Documentación de API
Para obtener información detallada sobre la API para desarrolladores de Govee Lights, incluidas sus funcionalidades, puntos de conexión, parámetros y respuestas, consulte la documentación oficial de la API govee. La documentación proporciona instrucciones y ejemplos completos que le ayudarán a integrar y usar eficazmente la API dentro de sus aplicaciones y flujos de trabajo.
Problemas conocidos y limitaciones
Actualmente, no existen problemas o limitaciones conocidos. Consulte siempre esta sección para obtener información actualizada.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API de Govee | securestring | La clave de API de Govee que se puede solicitar en la aplicación móvil govee. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Ejecutar comando en el dispositivo |
Ejecute un comando específico en un dispositivo Govee. Este punto de conexión permite controlar varios aspectos del dispositivo, como el estado de energía, el brillo, el color y la temperatura del color. Proporcione la dirección MAC y el modelo del dispositivo junto con los detalles del comando. Los comandos admitidos incluyen "turn" para el control de energía, "brillo" para ajustar los niveles de brillo, "color" para establecer valores de color RGB y "colorTem" para ajustar la temperatura del color. |
| Obtener información del dispositivo |
Acceda a información detallada sobre los dispositivos Govee. Este punto de conexión recupera los datos de un dispositivo específico cuando se proporciona con su dirección MAC y su modelo. Si no se especifica ningún dispositivo específico, el punto de conexión devuelve información de todos los dispositivos asociados a la cuenta. La respuesta incluye detalles del dispositivo, como el nombre del dispositivo, la controlabilidad, la capacidad de recuperación, los comandos admitidos y las propiedades adicionales. Esto es útil para comprender las funcionalidades y la configuración actual de los dispositivos Govee. |
Ejecutar comando en el dispositivo
Ejecute un comando específico en un dispositivo Govee. Este punto de conexión permite controlar varios aspectos del dispositivo, como el estado de energía, el brillo, el color y la temperatura del color. Proporcione la dirección MAC y el modelo del dispositivo junto con los detalles del comando. Los comandos admitidos incluyen "turn" para el control de energía, "brillo" para ajustar los niveles de brillo, "color" para establecer valores de color RGB y "colorTem" para ajustar la temperatura del color.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección MAC del dispositivo
|
device | True | string |
Dirección MAC única del dispositivo Govee. Este identificador se usa para especificar el dispositivo que desea controlar. |
|
Modelo del dispositivo
|
model | True | string |
Número de modelo del dispositivo Govee. Esta información ayuda a identificar las características y funcionalidades específicas disponibles para el dispositivo. |
|
Nombre del comando
|
name | True | string |
Comando que se va a ejecutar en el dispositivo. Este objeto incluye el nombre del comando (por ejemplo, "turn", "brightness", "color", "colorTem") y su valor asociado. El nombre del comando determina el tipo de acción que se va a realizar en el dispositivo. |
|
Turno
|
turn | string |
Este parámetro se usa para activar o desactivar el dispositivo. Úselo solo cuando se seleccione el comando 'turn'. Los valores válidos son "on" o "off". |
|
|
Brillo
|
brightness | integer |
Nivel de brillo que se va a establecer para el dispositivo. Use este parámetro solo cuando se seleccione el comando "brillo". Escriba un valor entre 0 (brillo mínimo) y 100 (brillo máximo). |
|
|
Color - Rojo
|
r | integer |
Este parámetro representa el componente rojo del valor de color RGB del dispositivo. Forma parte del comando "color". Especifique un valor entero comprendido entre 0 y 255, donde 0 significa que no hay rojo y 255 representa la intensidad máxima del rojo. |
|
|
Color - Verde
|
g | integer |
Este parámetro define el componente verde del valor de color RGB del dispositivo. Se usa junto con el comando "color". Proporcione un valor entero entre 0 y 255, con 0 que indica que no hay verde y 255 que indica la intensidad más alta de verde. |
|
|
Color - Azul
|
b | integer |
Componente azul del valor de color RGB que se va a establecer en el dispositivo. Este parámetro forma parte del comando "color". El valor debe ser un entero comprendido entre 0 y 255, donde 0 es la ausencia de azul y 255 denota el azul más brillante. |
|
|
Temperatura del color
|
colorTem | integer |
Valor de temperatura de color que se va a establecer para el dispositivo. Use este parámetro solo cuando se seleccione el comando "colorTem". Escriba el valor de temperatura del color según sea necesario para el dispositivo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Código de estado
|
code | integer |
Código de estado HTTP de la respuesta |
|
Message
|
message | string |
Mensaje que describe el resultado de la operación |
|
datos
|
data | object |
Los datos devueltos con la respuesta. |
Obtener información del dispositivo
Acceda a información detallada sobre los dispositivos Govee. Este punto de conexión recupera los datos de un dispositivo específico cuando se proporciona con su dirección MAC y su modelo. Si no se especifica ningún dispositivo específico, el punto de conexión devuelve información de todos los dispositivos asociados a la cuenta. La respuesta incluye detalles del dispositivo, como el nombre del dispositivo, la controlabilidad, la capacidad de recuperación, los comandos admitidos y las propiedades adicionales. Esto es útil para comprender las funcionalidades y la configuración actual de los dispositivos Govee.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección MAC del dispositivo
|
device | string |
Parámetro opcional que representa la dirección MAC del dispositivo Govee para el que se solicita información. Si se proporciona, la API devolverá detalles específicamente para este dispositivo. Deje este parámetro vacío para recuperar información de todos los dispositivos asociados a la cuenta. |
|
|
Modelo del dispositivo
|
model | string |
Parámetro opcional que indica el modelo del dispositivo Govee. Si se especifica, la API devolverá información para los dispositivos que coinciden con este modelo. Este parámetro se puede usar junto con la dirección MAC del dispositivo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Dispositivos
|
data.devices | array of object |
Lista de dispositivos asociados a la cuenta. Si se solicita un dispositivo específico, la lista solo contendrá un dispositivo. |
|
Dirección MAC del dispositivo
|
data.devices.device | string |
Dirección MAC única del dispositivo |
|
Modelo del dispositivo
|
data.devices.model | string |
Número de modelo del dispositivo |
|
Nombre del dispositivo
|
data.devices.deviceName | string |
Nombre del dispositivo |
|
Controlable
|
data.devices.controllable | boolean |
Indica si el dispositivo es controlable. |
|
Mínimo
|
data.devices.properties.colorTem.range.min | integer |
Valor mínimo de temperatura de color |
|
Máxima
|
data.devices.properties.colorTem.range.max | integer |
Valor máximo de temperatura de color |
|
Se puede recuperar
|
data.devices.retrievable | boolean |
Indica si el dispositivo se puede recuperar. |
|
Comandos admitidos
|
data.devices.supportCmds | array of string |
Comandos admitidos para el dispositivo |
|
Message
|
message | string |
Mensaje que describe el resultado de la operación |
|
Código de estado
|
code | integer |
Código de estado HTTP de la respuesta |