Philips HUE(Independent Publisher)
Philips HUE를 사용하면 조명, 스위치, 플러그 등과 같은 스마트 홈 디바이스를 제어할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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) |
| 연락처 | |
|---|---|
| 이름 | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| 전자 메일 | tomasz@poszytek.eu |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Tomasz Poszytek |
| 웹 사이트 | https://www.philips-hue.com/ |
| 개인 정보 보호 정책 | https://www.philips-hue.com/en-us/support/legal/privacy-policy |
| 카테고리 | 사물 인터넷; 라이프스타일 및 엔터테인먼트 |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| HUE 애플리케이션 키 | 시큐어스트링 (보안 문자열) | PUT 및 POST 권한 부여 호출을 수행한 후 반환되는 API 키입니다. | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 디바이스 가져오기 |
특정 디바이스의 세부 정보를 가져옵니다. |
| 디바이스 가져오기 |
모든 디바이스 목록을 가져옵니다. |
| 디바이스 실행 |
특정 디바이스를 실행합니다. |
| 밝게 실행 |
번개 기능이 있는 디바이스를 실행합니다. |
| 장면 가져오기 |
특정 장면의 세부 정보를 가져옵니다. |
| 장면 가져오기 |
모든 장면의 목록을 가져옵니다. 장면은 조명 그룹에 대한 설정을 저장하고 회수하는 데 사용됩니다. |
| 장면 삭제 |
특정 장면을 삭제합니다. |
| 조명 가져오기 |
번개 기능이 있는 특정 디바이스에 대한 세부 정보를 가져옵니다. |
| 조명 가져오기 |
번개 기능이 있는 디바이스 목록을 가져옵니다. |
| 회의실 가져오기 |
회의실(그룹) 목록을 가져옵니다. |
디바이스 가져오기
특정 디바이스의 세부 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
디바이스 ID
|
DeviceId | True | string |
세부 정보를 표시할 디바이스의 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
|
데이터
|
data | array of object |
지정된 ID와 일치하는 디바이스입니다. |
|
아이디
|
data.id | string |
특정 리소스 인스턴스를 나타내는 고유 식별자입니다. |
|
ID v1
|
data.id_v1 | string |
클립 v1 리소스 식별자(API v1에서 사용). |
|
원형
|
data.metadata.archetype | string |
제조업체에서 제공하는 기본 원형입니다. |
|
이름
|
data.metadata.name | string |
사람이 읽을 수 있는 리소스 이름입니다. |
|
인증
|
data.product_data.certified | boolean |
이 디바이스는 HUE 인증을 받았습니다. |
|
제조업체 이름
|
data.product_data.manufacturer_name | string |
디바이스 제조업체의 이름입니다. |
|
모델 ID
|
data.product_data.model_id | string |
디바이스 모델의 고유 식별입니다. |
|
제품 아키타입
|
data.product_data.product_archetype | string |
제품의 원형입니다. |
|
제품 이름
|
data.product_data.product_name | string |
제품의 이름입니다. |
|
소프트웨어 버전
|
data.product_data.software_version | string |
제품의 소프트웨어 버전입니다. |
|
Services
|
data.services | array of object |
그룹에 있는 자식의 제어 및 상태를 집계하는 모든 서비스를 참조합니다. |
|
제거
|
data.services.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.services.rtype | string |
참조된 리소스의 형식입니다. |
|
유형
|
data.type | string |
지원되는 리소스의 유형입니다. |
디바이스 가져오기
모든 디바이스 목록을 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
|
데이터
|
data | array of object |
사용자 디바이스. |
|
아이디
|
data.id | string |
특정 리소스 인스턴스를 나타내는 고유 식별자입니다. |
|
ID v1
|
data.id_v1 | string |
클립 v1 리소스 식별자(API v1에서 사용). |
|
원형
|
data.metadata.archetype | string |
제조업체에서 제공하는 기본 원형입니다. |
|
이름
|
data.metadata.name | string |
사람이 읽을 수 있는 리소스 이름입니다. |
|
인증
|
data.product_data.certified | boolean |
이 디바이스는 HUE 인증을 받았습니다. |
|
제조업체 이름
|
data.product_data.manufacturer_name | string |
디바이스 제조업체의 이름입니다. |
|
모델 ID
|
data.product_data.model_id | string |
디바이스 모델의 고유 식별입니다. |
|
제품 아키타입
|
data.product_data.product_archetype | string |
제품의 원형입니다. |
|
제품 이름
|
data.product_data.product_name | string |
제품의 이름입니다. |
|
소프트웨어 버전
|
data.product_data.software_version | string |
제품의 소프트웨어 버전입니다. |
|
Services
|
data.services | array of object |
그룹에 있는 자식의 제어 및 상태를 집계하는 모든 서비스를 참조합니다. |
|
제거
|
data.services.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.services.rtype | string |
참조된 리소스의 형식입니다. |
|
유형
|
data.type | string |
지원되는 리소스의 유형입니다. |
디바이스 실행
특정 디바이스를 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
디바이스 ID
|
DeviceId | True | string |
메타데이터를 업데이트할 디바이스의 ID입니다. |
|
원형
|
archetype | string |
기본적으로 제조업체에서 제공하는 원형입니다. |
|
|
이름
|
name | string |
사람이 읽을 수 있는 리소스 이름(최대 32자)입니다. |
|
|
조치
|
action | string |
식별을 트리거하려면 "identify"를 입력합니다. Bridge는 5초 동안 지그비 LED 식별 주기를 수행합니다. 조명은 하나의 호흡 주기를 수행합니다. 센서는 15초 동안 LED 식별 주기를 수행합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of object |
디바이스가 업데이트되었습니다. |
|
제거
|
data.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.rtype | string |
참조된 리소스의 형식입니다. |
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
밝게 실행
번개 기능이 있는 디바이스를 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
디바이스 ID
|
DeviceId | True | string |
속성을 업데이트할 디바이스의 ID입니다. |
|
이름
|
name | string |
MinLength: 1 - maxLength: 32. 사람이 읽을 수 있는 리소스 이름입니다. |
|
|
설정
|
on | boolean |
켜기/끄기 상태 on=true, off=false입니다. |
|
|
밝기
|
brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
|
미렉 주
|
mirek | integer |
최소: 153 - 최대: 500. 밝은 색이 ct 스펙트럼에 없는 경우 mirek 또는 null의 색 온도입니다. |
|
|
X
|
x | float |
최소: 0 - 최대: 1. 색 영역의 X 위치입니다. |
|
|
Y
|
y | float |
최소: 0 - 최대: 1. 색 영역의 Y 위치입니다. |
|
|
속도
|
speed | float |
최소: 0 - 최대: 1. 동적 색상표의 속도입니다. 상태가 dynamic_palette 경우 또는 상태에 나열된 해당 효과에 대해 동적 색상표에 대해 속도가 유효합니다. 상태가 없는 경우 속도가 유효하지 않습니다. |
|
|
기간
|
duration | integer |
최대: 6000000. 광원 전환 기간(밀리초)입니다. 정확도는 100ms 단계입니다. |
|
|
조치
|
action | string |
디바이스에서 실행할 수 있는 작업 중 하나입니다. 즉, "호흡"입니다. |
|
|
X
|
x | float |
최소: 0 - 최대: 1. 색 영역의 X 위치입니다. |
|
|
Y
|
y | float |
최소: 0 - 최대: 1. 색 영역의 Y 위치입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of object |
데이터 |
|
제거
|
data.rid | string |
제거 |
|
rtype
|
data.rtype | string |
rtype |
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
장면 가져오기
특정 장면의 세부 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
장면 ID
|
SceneId | True | string |
세부 정보를 표시할 장면의 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
|
데이터
|
data | array of object |
데이터. |
|
활동
|
data.actions | array of object |
장면에서 실행된 작업 목록입니다. |
|
X
|
data.actions.action.color.xy.x | float |
최소: 0 - 최대: 1. 색 영역의 X 위치입니다. |
|
Y
|
data.actions.action.color.xy.y | float |
최소: 0 - 최대: 1. 색 영역의 Y 위치입니다. |
|
밝기
|
data.actions.action.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
설정
|
data.actions.action.on.on | boolean |
켜기/끄기 상태 on=true, off=false입니다. |
|
미렉 주
|
data.actions.action.color_temperature.mirek | integer |
최소: 153 - 최대: 500. 밝은 색이 ct 스펙트럼에 없는 경우 mirek 또는 null의 색 온도입니다. |
|
제거
|
data.actions.target.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.actions.target.rtype | string |
참조된 리소스의 형식입니다. |
|
제거
|
data.group.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.group.rtype | string |
참조된 리소스의 형식입니다. |
|
아이디
|
data.id | string |
특정 리소스 인스턴스를 나타내는 고유 식별자입니다. |
|
ID v1
|
data.id_v1 | string |
클립 v1 리소스 식별자(API v1에서 사용). |
|
제거
|
data.metadata.image.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.metadata.image.rtype | string |
참조된 리소스의 형식입니다. |
|
이름
|
data.metadata.name | string |
사람이 읽을 수 있는 리소스 이름입니다. |
|
색깔
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
최소: 0 - 최대: 1. 색 영역의 X 위치입니다. |
|
Y
|
data.palette.color.color.xy.y | float |
최소: 0 - 최대: 1. 색 영역의 Y 위치입니다. |
|
밝기
|
data.palette.color.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
색 온도
|
data.palette.color_temperature | array of object | |
|
미렉 주
|
data.palette.color_temperature.color_temperature.mirek | integer |
최소: 153 - 최대: 500. 밝은 색이 ct 스펙트럼에 없는 경우 mirek 또는 null의 색 온도입니다. |
|
밝기
|
data.palette.color_temperature.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
디 밍
|
data.palette.dimming | array of object | |
|
밝기
|
data.palette.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
속도
|
data.speed | float |
이 장면에 대한 동적 색상표의 속도입니다. |
|
유형
|
data.type | string |
지원되는 리소스의 유형입니다. |
장면 가져오기
모든 장면의 목록을 가져옵니다. 장면은 조명 그룹에 대한 설정을 저장하고 회수하는 데 사용됩니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
|
데이터
|
data | array of object |
데이터. |
|
활동
|
data.actions | array of object |
장면에서 실행된 작업 목록입니다. |
|
X
|
data.actions.action.color.xy.x | float |
최소: 0 - 최대: 1. 색 영역의 X 위치입니다. |
|
Y
|
data.actions.action.color.xy.y | float |
최소: 0 - 최대: 1. 색 영역의 Y 위치입니다. |
|
밝기
|
data.actions.action.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
설정
|
data.actions.action.on.on | boolean |
켜기/끄기 상태 on=true, off=false입니다. |
|
미렉 주
|
data.actions.action.color_temperature.mirek | integer |
최소: 153 - 최대: 500. 밝은 색이 ct 스펙트럼에 없는 경우 mirek 또는 null의 색 온도입니다. |
|
제거
|
data.actions.target.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.actions.target.rtype | string |
참조된 리소스의 형식입니다. |
|
제거
|
data.group.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.group.rtype | string |
참조된 리소스의 형식입니다. |
|
아이디
|
data.id | string |
특정 리소스 인스턴스를 나타내는 고유 식별자입니다. |
|
ID v1
|
data.id_v1 | string |
클립 v1 리소스 식별자(API v1에서 사용). |
|
제거
|
data.metadata.image.rid | string |
참조된 리소스의 고유 ID입니다. |
|
rtype
|
data.metadata.image.rtype | string |
참조된 리소스의 형식입니다. |
|
이름
|
data.metadata.name | string |
사람이 읽을 수 있는 리소스 이름입니다. |
|
색깔
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
최소: 0 - 최대: 1. 색 영역의 X 위치입니다. |
|
Y
|
data.palette.color.color.xy.y | float |
최소: 0 - 최대: 1. 색 영역의 Y 위치입니다. |
|
밝기
|
data.palette.color.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
색 온도
|
data.palette.color_temperature | array of object | |
|
미렉 주
|
data.palette.color_temperature.color_temperature.mirek | integer |
최소: 153 - 최대: 500. 밝은 색이 ct 스펙트럼에 없는 경우 mirek 또는 null의 색 온도입니다. |
|
밝기
|
data.palette.color_temperature.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
디 밍
|
data.palette.dimming | array of object | |
|
밝기
|
data.palette.dimming.brightness | float |
최대: 100. 밝기 백분율입니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
속도
|
data.speed | float |
이 장면에 대한 동적 색상표의 속도입니다. |
|
유형
|
data.type | string |
지원되는 리소스의 유형입니다. |
장면 삭제
특정 장면을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
장면 ID
|
SceneId | True | string |
삭제할 장면의 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of object |
장면을 업데이트했습니다. |
|
제거
|
data.rid | string |
삭제된 장면의 고유 ID입니다. |
|
rtype
|
data.rtype | string |
삭제된 장면의 형식입니다. |
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
조명 가져오기
번개 기능이 있는 특정 디바이스에 대한 세부 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
디바이스 ID
|
DeviceId | True | string |
세부 정보를 표시할 디바이스의 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
|
데이터
|
data | array of object |
지정된 ID와 일치하는 조명입니다. |
|
작업 값
|
data.alert.action_values | array of string |
표시등이 지원하는 경고 효과 목록입니다. |
|
파란색 X
|
data.color.gamut.blue.x | float |
색 영역의 X 위치입니다. |
|
파란색 Y
|
data.color.gamut.blue.y | float |
색 영역의 Y 위치입니다. |
|
녹색 X
|
data.color.gamut.green.x | float |
색 영역의 X 위치입니다. |
|
녹색 Y
|
data.color.gamut.green.y | float |
색 영역의 X 위치입니다. |
|
빨간색 X
|
data.color.gamut.red.x | float |
색 영역의 X 위치입니다. |
|
빨강 Y
|
data.color.gamut.red.y | float |
색 영역의 X 위치입니다. |
|
영역 유형
|
data.color.gamut_type | string |
색상에서 지원하는 영역 유형: A - 초기 필립스 색상 전용 제품의 영역, B - 첫 번째 색조 색상 제품의 제한된 영역, C - 색조 흰색 및 색상 분위기 제품의 풍부한 색상 영역, 기타 - 비 색조 제품의 색상 영역. |
|
X
|
data.color.xy.x | float |
색 영역의 X 위치입니다. |
|
Y
|
data.color.xy.y | float |
색 영역의 Y 위치입니다. |
|
미렉 주
|
data.color_temperature.mirek | integer |
밝은 색이 ct 스펙트럼에 없는 경우 mirek 또는 null의 색 온도입니다. |
|
Mirek 최대값
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
이 조명이 지원하는 최대 색 온도입니다. |
|
Mirek 최소값
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
이 조명이 지원하는 최소 색 온도입니다. |
|
Mirek 유효
|
data.color_temperature.mirek_valid | boolean |
mirek에 표시되는 값이 유효한지 여부를 나타냅니다. |
|
밝기
|
data.dimming.brightness | float |
밝기 백분율입니다. 값은 0일 수 없습니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
최소 어둡게 수준
|
data.dimming.min_dim_level | float |
디바이스가 최소 밝기에서 출력하는 최대 루멘의 백분율입니다. |
|
속도
|
data.dynamics.speed | float |
동적 색상표 또는 효과의 속도입니다. 상태가 dynamic_palette 경우 또는 상태에 나열된 해당 효과에 대해 동적 색상표에 대해 속도가 유효합니다. 상태가 없는 경우 속도가 유효하지 않습니다. |
|
유효한 속도
|
data.dynamics.speed_valid | boolean |
속도에 표시된 값이 유효한지 여부를 나타냅니다. |
|
상태
|
data.dynamics.status | string |
동적이 있는 램프의 현재 상태입니다. |
|
상태 값
|
data.dynamics.status_values | array of string |
역동성을 재생할 때 램프가 될 수 있는 상태입니다. |
|
리소스 ID
|
data.id | string |
특정 리소스 인스턴스를 나타내는 고유 식별자입니다. |
|
v1 리소스 ID 클립
|
data.id_v1 | string |
클립 v1 리소스 식별자(v1 API 버전). |
|
원형
|
data.metadata.archetype | string |
밝은 원형입니다. 사용되지 않음: 디바이스 수준에서 아키타입을 사용합니다. |
|
지정된 디바이스 이름
|
data.metadata.name | string |
사람이 읽을 수 있는 리소스 이름입니다. |
|
Mode
|
data.mode | string |
다음 중 하나: 일반 또는 스트리밍. |
|
밝은 상태
|
data.on.on | boolean |
조명의 켜기/끄기 상태: on=true, off=false. |
|
RID
|
data.owner.rid | string |
참조된 리소스의 고유 ID입니다. |
|
Rtype
|
data.owner.rtype | string |
참조된 리소스의 형식입니다. |
|
유형
|
data.type | string |
지원되는 리소스의 유형입니다. |
조명 가져오기
번개 기능이 있는 디바이스 목록을 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
|
데이터
|
data | array of object |
사용자 표시등. |
|
작업 값
|
data.alert.action_values | array of string |
표시등이 지원하는 경고 효과 목록입니다. |
|
파란색 X
|
data.color.gamut.blue.x | float |
색 영역의 X 위치입니다. |
|
파란색 Y
|
data.color.gamut.blue.y | float |
색 영역의 Y 위치입니다. |
|
녹색 X
|
data.color.gamut.green.x | float |
색 영역의 X 위치입니다. |
|
녹색 Y
|
data.color.gamut.green.y | float |
색 영역의 X 위치입니다. |
|
빨간색 X
|
data.color.gamut.red.x | float |
색 영역의 X 위치입니다. |
|
빨강 Y
|
data.color.gamut.red.y | float |
색 영역의 X 위치입니다. |
|
영역 유형
|
data.color.gamut_type | string |
색상에서 지원하는 영역 유형: A - 초기 필립스 색상 전용 제품의 영역, B - 첫 번째 색조 색상 제품의 제한된 영역, C - 색조 흰색 및 색상 분위기 제품의 풍부한 색상 영역, 기타 - 비 색조 제품의 색상 영역. |
|
X
|
data.color.xy.x | float |
색 영역의 X 위치입니다. |
|
Y
|
data.color.xy.y | float |
색 영역의 Y 위치입니다. |
|
미렉 주
|
data.color_temperature.mirek | integer |
밝은 색이 ct 스펙트럼에 없는 경우 mirek 또는 null의 색 온도입니다. |
|
Mirek 최대값
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
이 조명이 지원하는 최대 색 온도입니다. |
|
Mirek 최소값
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
이 조명이 지원하는 최소 색 온도입니다. |
|
Mirek 유효
|
data.color_temperature.mirek_valid | boolean |
mirek에 표시되는 값이 유효한지 여부를 나타냅니다. |
|
밝기
|
data.dimming.brightness | float |
밝기 백분율입니다. 값은 0일 수 없습니다. 0을 작성하면 가능한 가장 낮은 밝기로 변경됩니다. |
|
최소 어둡게 수준
|
data.dimming.min_dim_level | float |
디바이스가 최소 밝기에서 출력하는 최대 루멘의 백분율입니다. |
|
속도
|
data.dynamics.speed | float |
동적 색상표 또는 효과의 속도입니다. 상태가 dynamic_palette 경우 또는 상태에 나열된 해당 효과에 대해 동적 색상표에 대해 속도가 유효합니다. 상태가 없는 경우 속도가 유효하지 않습니다. |
|
유효한 속도
|
data.dynamics.speed_valid | boolean |
속도에 표시된 값이 유효한지 여부를 나타냅니다. |
|
상태
|
data.dynamics.status | string |
동적이 있는 램프의 현재 상태입니다. |
|
상태 값
|
data.dynamics.status_values | array of string |
역동성을 재생할 때 램프가 될 수 있는 상태입니다. |
|
리소스 ID
|
data.id | string |
특정 리소스 인스턴스를 나타내는 고유 식별자입니다. |
|
v1 리소스 ID 클립
|
data.id_v1 | string |
클립 v1 리소스 식별자(v1 API 버전). |
|
원형
|
data.metadata.archetype | string |
밝은 원형입니다. 사용되지 않음: 디바이스 수준에서 아키타입을 사용합니다. |
|
지정된 디바이스 이름
|
data.metadata.name | string |
사람이 읽을 수 있는 리소스 이름입니다. |
|
Mode
|
data.mode | string |
다음 중 하나: 일반 또는 스트리밍. |
|
밝은 상태
|
data.on.on | boolean |
조명의 켜기/끄기 상태: on=true, off=false. |
|
RID
|
data.owner.rid | string |
참조된 리소스의 고유 ID입니다. |
|
Rtype
|
data.owner.rtype | string |
참조된 리소스의 형식입니다. |
|
유형
|
data.type | string |
지원되는 리소스의 유형입니다. |
회의실 가져오기
회의실(그룹) 목록을 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
오류
|
errors | array of object |
호출 중에 발생한 오류입니다. |
|
오류 설명
|
errors.description | string |
이 문제 발생과 관련된 사람이 읽을 수 있는 설명입니다. |
|
데이터
|
data | array of object |
데이터. |
|
하위
|
data.children | array of object |
회의실별로 그룹화할 디바이스입니다. 다음 자식이 허용됩니다. "device". |
|
제거
|
data.children.rid | string |
만든 장면의 고유 ID입니다. |
|
rtype
|
data.children.rtype | string |
만든 장면의 형식입니다. |
|
그룹화된 서비스
|
data.grouped_services | array of object |
집계된 제어 서비스에 대한 참조입니다. 사용되지 않음: 서비스를 사용합니다. |
|
제거
|
data.grouped_services.rid | string |
만든 장면의 고유 ID입니다. |
|
rtype
|
data.grouped_services.rtype | string |
만든 장면의 형식입니다. |
|
아이디
|
data.id | string |
특정 리소스 인스턴스를 나타내는 고유 식별자입니다. |
|
ID v1
|
data.id_v1 | string |
클립 v1 리소스 식별자(API v1에서 사용). |
|
원형
|
data.metadata.archetype | string |
제조업체에서 제공하는 기본 원형입니다. |
|
이름
|
data.metadata.name | string |
사람이 읽을 수 있는 리소스 이름입니다. |
|
Services
|
data.services | array of object |
그룹에 있는 자식의 제어 및 상태를 집계하는 모든 서비스를 참조합니다. 집계는 서비스 유형별로, 즉 그룹화할 수 있는 모든 서비스 유형에 그룹화된 형식의 해당 정의가 있습니다. 지원되는 형식: "light". |
|
제거
|
data.services.rid | string |
만든 장면의 고유 ID입니다. |
|
rtype
|
data.services.rtype | string |
만든 장면의 형식입니다. |
|
유형
|
data.type | string |
지원되는 리소스의 유형입니다. |