智能家居能源存储特征架构
action.devices.traits.EnergyStorage
- 此特征所属的设备会将电量存储在电池中,并且可能会充电,或者设备可以为其他设备充电。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
queryOnlyEnergyStorage |
Boolean |
必填。 如果此设备仅支持对存储的电量水平和(可选)主动充电状态(具体取决于 |
energyStorageDistanceUnitForUX |
String |
(默认值: 将在对用户的回复中使用。 支持的值:
|
isRechargeable |
Boolean |
(默认值: 如果此设备可充电,则设置为 true。这表示设备可以报告 |
示例
可充电设备
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
目前以英里为单位显示当前充电水平的可充电设备
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
仅支持报告当前费用水平的不可充电设备
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
设备状态
具有此特征的设备可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
descriptiveCapacityRemaining |
String |
必填。 能源容量水平的定性说明。请注意,这适用于没有数值容量数据的情况。如果同样提供数字容量数据,则这些数据将尽可能优先于描述性数据。 支持的值:
|
capacityRemaining |
数组 |
单位/值对的数组,用于保存设备当前存储的能量容量的信息。例如:“我的设备目前有多少英里”或“我的设备按多少百分比充电” |
[item, ...] |
对象 |
单位和值对的剩余容量。 |
rawValue |
整数 |
必填。 容量值。 |
unit |
String |
必填。 容量单位。 支持的值:
|
capacityUntilFull |
数组 |
此单元中的一对值,用于存放容量的相关信息,直到设备充满电。例如:距离 <device> 充满电还剩多长时间。 |
[item, ...] |
对象 |
充电前的容量。 |
rawValue |
整数 |
必填。 容量值。 |
unit |
String |
必填。 容量单位。 支持的值:
|
isCharging |
Boolean |
设备目前是否正在充电。 |
isPluggedIn |
Boolean |
设备目前是否已接通电源。设备可以插上电源,但无法主动充电。 |
示例
可充电设备
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
目前以英里为单位显示当前充电水平的可充电设备
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
仅支持报告当前电量的不可充电设备
{ "descriptiveCapacityRemaining": "LOW" }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.Charge
开始或停止充电。
此命令需要以下特性:{ "isRechargeable": true }
参数
参数 | 类型 | 说明 |
---|---|---|
charge |
Boolean |
必填。 True 以开始充电,False 停止充电。 |
示例
开始充电命令
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
停止充电命令
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
设备出错
查看错误和异常的完整列表。deviceUnplugged
:用户尝试对未接通电源的设备进行充电。