스마트 홈 채우기 특성 스키마
action.devices.traits.Fill
- 이 특성은 욕조와 같이 충전을 지원하는 기기에 적용됩니다.
기기 ATTRIBUTES
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
availableFillLevels |
객체 |
기기를 채우는 다양한 수준을 설명합니다. |
levels |
배열 |
필수사항. 수준 이름 및 언어별 동의어 목록 |
[item, ...] |
객체 |
등급 이름 및 언어별 동의어입니다. |
level_name |
String |
필수사항. 레벨의 내부 이름입니다. 사용자 친화적이지 않을 수 있으며 모든 언어에서 공유됩니다. |
level_values |
배열 |
필수사항. 지원되는 각 언어로 된 수준의 동의어입니다. |
[item, ...] |
객체 |
지정된 언어 수준의 동의어입니다. |
level_synonym |
배열 |
필수사항. 층의 동의어입니다. 이 목록의 첫 번째 문자열은 해당 언어 수준의 표준 이름으로 사용됩니다. |
[item, ...] |
String |
동의어 이름입니다. |
lang |
String |
필수사항. 언어 코드 (ISO 639-1)입니다. 지원되는 언어를 참고하세요. |
ordered |
Boolean |
필수사항. true인 경우 기기는 |
supportsFillPercent |
Boolean |
(기본값: true인 경우 수준을 백분율로 조정하기 위한 명령어를 수락합니다. |
예시
불연속 채우기 수준을 지원하지 않는 기본 채우기 또는 배출 기능이 있는 기기.
{}
별도의 채우기 수준을 지원하는 기기.
{ "availableFillLevels": { "levels": [ { "level_name": "half_level", "level_values": [ { "level_synonym": [ "Half", "Half way", "One half" ], "lang": "en" } ] }, { "level_name": "full_level", "level_values": [ { "level_synonym": [ "Full", "All the way", "Complete" ], "lang": "en" } ] } ], "ordered": true } }
기기 상태
이 특성을 가진 항목은 QUERY
작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
상태 | 유형 | 설명 |
---|---|---|
isFilled |
Boolean |
필수사항. 기기가 어느 수준까지든 채워져 있으면 true입니다. 기기가 완전히 방전되면 false입니다. |
currentFillLevel |
String |
|
currentFillPercent |
Number |
|
예시
욕조가 채워졌나요?
{ "isFilled": true }
욕조가 채워졌나요? (레벨 포함)
{ "isFilled": true, "currentFillLevel": "half_level" }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.Fill
기기를 채우거나 배출합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
fill |
Boolean |
필수사항. 채워야 할 True, 소모하는 경우 False. |
fillLevel |
String |
설정할 |
fillPercent |
Number |
요청된 등급 비율을 나타냅니다. |
예시
욕조를 채우세요.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
욕조의 물을 뺍니다.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
욕조를 절반 정도 채웁니다.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
욕조 채우기 수준을 1씩 늘립니다 (ordered
속성이 true
이어야 함).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }