스마트 홈 채우기 트레잇 스키마
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 |
숫자 |
|
예
욕조가 채워져 있나요?
{
"isFilled": true
}
욕조가 채워져 있나요? (등급 포함)
{
"isFilled": true,
"currentFillLevel": "half_level"
}
기기 명령어
이 특성을 가진 기기는 다음에 응답할 수 있습니다.
EXECUTE 작업의 일부로 사용할 수 있습니다. 배우기 위해
EXECUTE 인텐트 처리에 관한 자세한 내용은
인텐트 처리.
action.devices.commands.Fill
기기를 채우거나 배출합니다.
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
fill |
Boolean |
필수사항. 채우려면 True, 소모하려면 false입니다. |
fillLevel |
String |
설정할 |
fillPercent |
숫자 |
요청된 등급 비율을 나타냅니다. |
예
욕조를 채우세요.
{
"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"
}
}