智能家居 EnergyStorage 特征架构

action.devices.traits.EnergyStorage - 此特征属于可通过电池存储能量并可能再次充电的设备，或可为其他设备充电的设备。

设备属性

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

属性	类型	说明
queryOnlyEnergyStorage	Boolean	必填。 如果设备仅支持查询存储的能量水平和（可选）活跃充电状态（依赖于 isRechargeable 属性），但不支持开始和停止充电，则为 true。
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	数组	包含设备当前存储的能量容量信息的单位/值对数组。例如：“我的 <device> 目前已行驶多少英里”或“我的 <device> 已充电多少百分比”
[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：用户尝试为未插接的设备充电。