엘가토 키라이트 API

엘가토 키 라이트 API

소개

Elgato Key Light 및 Key Light Air는 Twitch와 같은 플랫폼의 라이브 스트리머에게 인기가 있는 가장자리 조명 LED 비디오 조명입니다. 이러한 조명은 IoT 장치이며 일반적으로 Elgato의 'Control Center' 앱 또는 Stream Deck 장치(또한 Elgato에서 제조) 중 하나를 통해 제어됩니다. Key Light 장치는 기본적으로 타사 통합을 지원하지 않지만 조명의 내장 API와 직접 인터페이스하여 제어할 수 있습니다.

API 발견

'제어 센터' 앱은 HTTP를 통해 연결된 Key Light 장치에 명령을 보냅니다. 이 문서에 정의된 API 요청은 Wireshark 및 Elgato 'Control Center' 앱(Windows 10)의 참조 버전 1.1.2를 사용하여 발견되었습니다.

엔드포인트

장치 IP 주소

Key Light 장치는 네트워크에 추가된 후 DHCP를 통해 라우터로부터 IP 주소를 받을 가능성이 높습니다. 특정 IP 주소는 DHCP 서버/네트워크 라우터에서 가져올 수 있지만 '제어 센터' 앱에서도 쉽게 접근할 수 있습니다. 이렇게 하려면:

1. '제어 센터' 앱 실행/열기
2. 장치 이름 옆에 있는 Accessory settings 아이콘(슬라이더 모양)을 클릭합니다.
3. Advanced 섹션을 확장합니다. IP 주소는 전원 켜기 동작 및 펌웨어 버전 아래에 표시됩니다.

장치 포트

Key Light 장치는 포트 9123 에서 명령을 수신합니다.

기본 URL

모든 요청은 /elgato 로 전송되어야 합니다.

예

기기의 현재 설정을 가져옵니다.

 curl --location --request GET 'http://192.168.1.61:9123/elgato/lights' --header 'Accept: application/json'

입증

Key Light 장치에는 인증이 필요하지 않습니다.

응답

Key Light 장치는 두 개의 HTTP 상태 코드만 반환합니다.

• 200 OK 요청이 성공했습니다.
• 400 Bad Request 장치가 요청을 이해하지 못했습니다(잘못된 구문으로 인해 발생했을 수 있음).

또한 장치에서 반환되는 모든 데이터는 JSON 형식입니다.

자원

Key Light API로 구현되는 리소스는 세 가지뿐입니다.

• lights 조명 개체에는 키 라이트 장치의 현재 상태, 밝기 및 색온도와 관련된 정보가 포함되어 있습니다.
• accessory-info 액세서리 정보 개체에는 키 라이트 장치의 물리적 하드웨어 사양과 관련된 정보가 포함되어 있습니다.
• settings 설정 개체에는 Key Light 장치의 동작과 관련된 정보가 포함되어 있습니다.

기능

Key Light API에 의해 구현된 하나의 '작업'이 있습니다.

• 이 끝점에 HTTP POST 요청을 identify 해당 표시등이 몇 번 깜박이게 됩니다.