스마트 홈 채우기 특성 스키마
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 } }
기기 상태: STATES
이 특성이 있는 항목은 QUERY
작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
상태 | 유형 | 설명 |
---|---|---|
isFilled |
Boolean |
필수. 기기가 모든 수준으로 채워지면 참입니다. 기기가 완전히 드레이닝되면 false입니다. |
currentFillLevel |
String |
|
currentFillPercent |
Number |
|
예시
욕조가 채워져 있나요?
{ "isFilled": true }
욕조가 채워져 있나요? (등급 포함).
{ "isFilled": true, "currentFillLevel": "half_level" }
기기 COMMANDS
이 특성이 있는 기기는 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" } }