智能家居填充特征架构
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" } }