智能家居填充特征架构
action.devices.traits.Fill
- 此特征适用于支持加水的设备,例如浴缸。
设备属性
具有此特征的设备可以在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
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
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
isFilled |
Boolean |
必填。 如果设备已填充到任何级别,则返回 true。如果设备完全排空,则返回 false。 |
currentFillLevel |
String |
如果设置了 |
currentFillPercent |
编号 |
如果设置了 |
示例
浴缸已加满吗?
{ "isFilled": true }
浴缸已加满吗?(包含关卡)。
{ "isFilled": true, "currentFillLevel": "half_level" }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
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" } }