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