Elgato Key Light y Key Light Air son luces de video LED con iluminación de borde que son populares entre los transmisores en vivo en plataformas como Twitch. Estas luces son dispositivos IoT y normalmente se controlan con la aplicación 'Control Center' de Elgato o mediante uno de los dispositivos Stream Deck (también fabricado por Elgato). Los dispositivos Key Light no admiten de forma nativa la integración de terceros, pero se pueden controlar interactuando directamente con la API integrada de las luces.
La aplicación 'Centro de control' envía comandos a los dispositivos Key Light a los que se ha asociado a través de HTTP. Las solicitudes de API definidas en este documento se encontraron utilizando Wireshark y la versión de referencia 1.1.2 de la aplicación Elgato 'Control Center' (Windows 10).
Después de agregarse a una red, los dispositivos Key Light probablemente reciban direcciones IP de un enrutador a través de DHCP. Se pueden obtener direcciones IP específicas del servidor DHCP/enrutador de red, pero también se puede acceder fácilmente a ellas en la aplicación 'Centro de control'. Para hacer esto:
Accessory settings (con forma de control deslizante) al lado del nombre de un dispositivoAdvanced . La dirección IP se presentará en Comportamiento de encendido y Versión de firmwareLos dispositivos Key Light escuchan comandos en el puerto 9123 .
Todas las solicitudes deben enviarse a /elgato .
Obtenga la configuración actual de un dispositivo:
curl --location --request GET 'http://192.168.1.61:9123/elgato/lights' --header 'Accept: application/json'
Los dispositivos Key Light no requieren autenticación.
Los dispositivos Key Light solo devuelven dos códigos de estado HTTP:
200 OK La solicitud ha sido exitosa.400 Bad Request El dispositivo no entendió la solicitud (probablemente debido a una sintaxis incorrecta)Además, todos los datos devueltos por un dispositivo tendrán formato JSON.
Solo hay tres recursos implementados por Key Light API
lights contienen información relacionada con el estado actual, el brillo y la temperatura de color de un dispositivo de luz clave.accessory-info contienen información relacionada con las especificaciones de hardware físico de un dispositivo Key Light.settings contienen información relacionada con el comportamiento de un dispositivo Key Light. Hay una 'acción' implementada por Key Light API:
identify el envío de una solicitud HTTP POST a este punto final hará que la luz dada parpadee varias veces
