智能家居能源存储特征架构

action.devices.traits.EnergyStorage - 此特征所属的设备会将电量存储在电池中，并且可能会充电，或者设备可以为其他设备充电。

设备属性

具有此特征的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性	类型	说明
queryOnlyEnergyStorage	Boolean	必填。 如果此设备仅支持对存储的电量水平和（可选）主动充电状态（具体取决于 isRechargeable 属性）的查询，但不支持查询，则不支持开始和停止充电。
energyStorageDistanceUnitForUX	String	（默认值："KILOMETERS"） 将在对用户的回复中使用。 支持的值： KILOMETERS MILES
isRechargeable	Boolean	（默认值：false） 如果此设备可充电，则设置为 true。这表示设备可以报告 capacityUntilFull、isCharging 以及可选的 isPluggedIn 状态，并且可以接受 Charge 命令。

示例

可充电设备

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

目前以英里为单位显示当前充电水平的可充电设备

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

仅支持报告当前费用水平的不可充电设备

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

设备状态

具有此特征的设备可能会在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅 intent 执行方式。

州	类型	说明
descriptiveCapacityRemaining	String	必填。 能源容量水平的定性说明。请注意，这适用于没有数值容量数据的情况。如果同样提供数字容量数据，则这些数据将尽可能优先于描述性数据。 支持的值： CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	数组	单位/值对的数组，用于保存设备当前存储的能量容量的信息。例如：“我的设备目前有多少英里”或“我的设备按多少百分比充电”
[item, ...]	对象	单位和值对的剩余容量。
rawValue	整数	必填。 容量值。
unit	String	必填。 容量单位。 支持的值： SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	数组	此单元中的一对值，用于存放容量的相关信息，直到设备充满电。例如：距离 <device> 充满电还剩多长时间。
[item, ...]	对象	充电前的容量。
rawValue	整数	必填。 容量值。
unit	String	必填。 容量单位。 支持的值： SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
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：用户尝试对未接通电源的设备进行充电。