고브 (독립 퍼블리셔) (미리 보기)
Govee 개발자 API를 사용하여 Govee 스마트 라이트 디바이스를 애플리케이션에 통합합니다. 조명을 제어하고, 색을 변경하고, 밝기를 조정하고, 타이머를 설정합니다. 고급 애플리케이션 개발을 위한 실시간 디바이스 상태에 액세스합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 리처드 윌슨 |
| URL | https://www.richardawilson.com/ |
| 전자 메일 | richard.a.wilson@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 리처드 윌슨 |
| 웹 사이트 | https://us.govee.com/ |
| 개인 정보 보호 정책 | https://us.govee.com/policies/privacy-policy |
| 카테고리 | 사물 인터넷 |
고브 ()
사용자가 장치를 손쉽게 제어하고 관리할 수 있도록 Govee의 스마트 조명 시스템과 원활하게 통합됩니다. 조명 설정 조정, 색 변경, 밝기 수정, 실시간 디바이스 상태 액세스 등 다양한 기능을 사용할 수 있습니다.
조명 설정을 자동화하고 사용자 지정하는 기능을 통해 이 커넥터는 스마트 홈의 분위기를 향상시키고, 다양한 경우에 동적 조명 장면을 만들고, 스마트 조명을 더 넓은 홈 자동화 시스템에 통합하는 데 특히 유용합니다. 사용자가 조명 환경을 개인화하고 Govee의 스마트 조명 기술의 기능을 완전히 활용할 수 있는 편리하고 직관적인 방법을 제공합니다.
출판사: 리처드 윌슨
필수 조건
Govee 커넥터를 사용하려면 먼저 Govee 개발자 API 키를 가져와야 합니다. 키를 획득하려면 다음 단계를 수행합니다.
Govee 개발자 API 키 가져오기
Govee 홈 앱을 다운로드합니다.
- iOS의 경우: App Store의 Govee Home
- 안드로이드 : 구글 플레이에 고브 홈
프로필에 액세스:
- Govee 홈 앱을 열고 프로필 아이콘(👤)을 탭하여 '내 프로필' 페이지로 이동합니다.
설정으로 이동:
- 오른쪽 위 모서리에 있는 설정 아이콘(⚙️)을 클릭하여 설정 메뉴에 액세스합니다.
API 키 적용:
- 설정 메뉴에서 'API 키에 적용'을 선택합니다.
전체 애플리케이션 양식:
- '이름' 및 '애플리케이션 이유'에 필요한 필드를 입력합니다.
- 예를 들어 홈 자동화, 타사 통합 또는 교육 목적이 있습니다.
- '이름' 및 '애플리케이션 이유'에 필요한 필드를 입력합니다.
서비스 약관에 동의:
- Govee 개발자 API 서비스 약관을 주의 깊게 읽어 보세요. 약관을 이해했으면 확인란을 선택하여 동의를 표시합니다.
애플리케이션 제출:
- '제출'을 클릭하여 API 키에 대한 애플리케이션을 보냅니다. 승인되면 이 커넥터를 사용하는 데 필요한 Govee API 키를 받게 됩니다.
API 키 승인 프로세스에는 다소 시간이 걸릴 수 있으며 승인은 Govee의 재량에 따라 결정됩니다. 애플리케이션에 승인 가능성을 높이기 위해 API 키를 요청하는 유효하고 명확한 이유가 포함되어 있는지 확인합니다.
지원되는 작업
1. 디바이스에서 명령 실행
이 작업을 통해 다양한 명령을 전송하여 Govee 디바이스를 제어할 수 있습니다.
-
입력 속성:
- 디바이스 MAC 주소: 제어할 Govee 디바이스의 고유한 MAC 주소입니다.
- 디바이스 모델: Govee 디바이스의 모델 번호입니다.
-
명령 세부 정보: 실행할 명령을 포함하는 개체입니다. 여기에는 다음이 포함됩니다.
- 이름: 명령 이름(예: 'turn', 'brightness', 'color', 'colorTem')입니다.
- 추가 매개 변수(명령 기반):
- Turn: (선택 사항) 'on' 또는 'off' - 명령이 'turn'일 때 사용됩니다.
- 밝기: (선택 사항) 숫자 값(0-100) - 명령이 '밝기'일 때 사용됩니다.
- Color: (선택 사항) 'r', 'g', 'b' 값이 있는 개체 - 명령이 'color'일 때 사용됩니다.
- 색 온도: (선택 사항) 색 온도에 대한 숫자 값 - 명령이 'colorTem'일 때 사용됩니다.
2. 디바이스 정보 가져오기
특정 Govee 디바이스 또는 계정과 연결된 모든 디바이스에 대한 정보를 검색합니다.
-
입력 속성:
- 디바이스 MAC 주소: (선택 사항) 정보가 요청되는 특정 Govee 디바이스의 MAC 주소입니다. 생략하면 모든 디바이스에 대한 정보가 반환됩니다.
- 디바이스 모델: (선택 사항) Govee 디바이스의 모델입니다. MAC 주소와 함께 지정된 경우 쿼리를 해당 특정 디바이스로 구체화합니다.
API 설명서
기능, 엔드포인트, 매개 변수 및 응답을 포함하여 Govee Lights 개발자 API에 대한 자세한 내용은 공식 Govee API 설명서를 참조하세요. 이 설명서는 애플리케이션 및 워크플로 내에서 API를 효과적으로 통합하고 활용하는 데 도움이 되는 포괄적인 지침과 예제를 제공합니다.
알려진 문제 및 제한 사항
현재 알려진 문제 또는 제한 사항이 없습니다. 업데이트된 정보는 항상 이 섹션을 참조하세요.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Govee API 키 | 시큐어스트링 (보안 문자열) | Govee 모바일 앱 내에서 요청할 수 있는 Govee API 키입니다. | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 디바이스 정보 가져오기 |
Govee 디바이스에 대한 자세한 정보에 액세스합니다. 이 엔드포인트는 MAC 주소 및 모델과 함께 제공되는 경우 특정 디바이스에 대한 데이터를 검색합니다. 특정 디바이스가 지정되지 않은 경우 엔드포인트는 계정과 연결된 모든 디바이스에 대한 정보를 반환합니다. 응답에는 디바이스 이름, 제어 가능성, 검색 가능성, 지원되는 명령 및 추가 속성과 같은 디바이스 세부 정보가 포함됩니다. 이는 Govee 디바이스의 기능 및 현재 구성을 이해하는 데 유용합니다. |
| 디바이스에서 명령 실행 |
Govee 디바이스에서 특정 명령을 실행합니다. 이 엔드포인트를 사용하면 전원 상태, 밝기, 색 및 색 온도와 같은 디바이스의 다양한 측면을 제어할 수 있습니다. 명령 세부 정보와 함께 디바이스의 MAC 주소 및 모델을 제공합니다. 지원되는 명령에는 전원 제어를 위한 'turn', 밝기 수준을 조정하기 위한 '밝기', RGB 색 값을 설정하는 '색', 색 온도를 조정하기 위한 'colorTem'이 포함됩니다. |
디바이스 정보 가져오기
Govee 디바이스에 대한 자세한 정보에 액세스합니다. 이 엔드포인트는 MAC 주소 및 모델과 함께 제공되는 경우 특정 디바이스에 대한 데이터를 검색합니다. 특정 디바이스가 지정되지 않은 경우 엔드포인트는 계정과 연결된 모든 디바이스에 대한 정보를 반환합니다. 응답에는 디바이스 이름, 제어 가능성, 검색 가능성, 지원되는 명령 및 추가 속성과 같은 디바이스 세부 정보가 포함됩니다. 이는 Govee 디바이스의 기능 및 현재 구성을 이해하는 데 유용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
디바이스 MAC 주소
|
device | string |
정보가 요청되는 Govee 디바이스의 MAC 주소를 나타내는 선택적 매개 변수입니다. 제공된 경우 API는 이 디바이스에 대한 세부 정보를 반환합니다. 계정과 연결된 모든 디바이스에 대한 정보를 검색하려면 이 매개 변수를 비워 둡니다. |
|
|
장치 모델
|
model | string |
Govee 디바이스의 모델을 나타내는 선택적 매개 변수입니다. 지정된 경우 API는 이 모델과 일치하는 디바이스에 대한 정보를 반환합니다. 이 매개 변수는 디바이스 MAC 주소와 함께 사용할 수 있습니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Devices
|
data.devices | array of object |
계정과 연결된 디바이스 목록입니다. 특정 디바이스가 요청되면 목록에 하나의 디바이스만 포함됩니다. |
|
디바이스 MAC 주소
|
data.devices.device | string |
디바이스의 고유한 MAC 주소 |
|
장치 모델
|
data.devices.model | string |
디바이스의 모델 번호 |
|
디바이스 이름
|
data.devices.deviceName | string |
디바이스의 이름 |
|
제어
|
data.devices.controllable | boolean |
디바이스를 제어할 수 있는지를 나타냅니다. |
|
최소
|
data.devices.properties.colorTem.range.min | integer |
최소 색 온도 값 |
|
최대
|
data.devices.properties.colorTem.range.max | integer |
최대 색 온도 값 |
|
조회 가능
|
data.devices.retrievable | boolean |
디바이스를 검색할 수 있는지를 나타냅니다. |
|
지원되는 명령
|
data.devices.supportCmds | array of string |
디바이스에 대해 지원되는 명령 |
|
Message
|
message | string |
작업 결과를 설명하는 메시지 |
|
상태 코드
|
code | integer |
응답의 HTTP 상태 코드 |
디바이스에서 명령 실행
Govee 디바이스에서 특정 명령을 실행합니다. 이 엔드포인트를 사용하면 전원 상태, 밝기, 색 및 색 온도와 같은 디바이스의 다양한 측면을 제어할 수 있습니다. 명령 세부 정보와 함께 디바이스의 MAC 주소 및 모델을 제공합니다. 지원되는 명령에는 전원 제어를 위한 'turn', 밝기 수준을 조정하기 위한 '밝기', RGB 색 값을 설정하는 '색', 색 온도를 조정하기 위한 'colorTem'이 포함됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
디바이스 MAC 주소
|
device | True | string |
Govee 디바이스의 고유한 MAC 주소입니다. 이 식별자는 제어할 디바이스를 지정하는 데 사용됩니다. |
|
장치 모델
|
model | True | string |
Govee 디바이스의 모델 번호입니다. 이 정보는 디바이스에 사용할 수 있는 특정 기능 및 기능을 식별하는 데 도움이 됩니다. |
|
명령 이름
|
name | True | string |
디바이스에서 실행할 명령입니다. 이 개체에는 명령 이름(예: 'turn', 'brightness', 'color', 'colorTem') 및 관련 값이 포함됩니다. 명령 이름은 디바이스에서 수행할 작업 유형을 지정합니다. |
|
턴
|
turn | string |
이 매개 변수는 디바이스를 켜거나 끄는 데 사용됩니다. 'turn' 명령을 선택한 경우에만 사용합니다. 유효한 값은 'on' 또는 'off'입니다. |
|
|
밝기
|
brightness | integer |
디바이스에 대해 설정할 밝기 수준입니다. 'brightness' 명령을 선택한 경우에만 이 매개 변수를 사용합니다. 0(최소 밝기)에서 100(최대 밝기) 사이의 값을 입력합니다. |
|
|
색 - 빨강
|
r | integer |
이 매개 변수는 디바이스에 대한 RGB 색 값의 빨간색 구성 요소를 나타냅니다. 'color' 명령의 일부입니다. 0에서 255 사이의 정수 값을 지정합니다. 여기서 0은 빨간색이 아니고 255는 빨간색의 최대 강도를 나타냅니다. |
|
|
색 - 녹색
|
g | integer |
이 매개 변수는 디바이스에 대한 RGB 색 값의 녹색 구성 요소를 정의합니다. 'color' 명령과 함께 사용됩니다. 0에서 255 사이의 정수 값을 제공하고, 0은 녹색을 나타내고 255는 녹색의 가장 높은 강도를 나타냅니다. |
|
|
색 - 파랑
|
b | integer |
디바이스에서 설정할 RGB 색 값의 파란색 구성 요소입니다. 이 매개 변수는 'color' 명령의 일부입니다. 값은 0에서 255 사이의 정수여야 합니다. 여기서 0은 파란색이 없고 255는 가장 밝은 파란색을 나타냄 |
|
|
색 온도
|
colorTem | integer |
디바이스에 대해 설정할 색 온도 값입니다. 'colorTem' 명령을 선택한 경우에만 이 매개 변수를 사용합니다. 디바이스에 필요한 색 온도 값을 입력합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
상태 코드
|
code | integer |
응답의 HTTP 상태 코드 |
|
Message
|
message | string |
작업 결과를 설명하는 메시지 |
|
데이터
|
data | object |
응답과 함께 반환된 데이터입니다. |