스마트 홈 채우기 특성 스키마
action.devices.traits.Fill
: 이 특성은 욕조와 같이 물을 채우도록 지원하는 기기에 적용됩니다.
기기 속성
이 특성이 있는 기기는 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" } }