智能家居储能特性架构

action.devices.traits.EnergyStorage - 此特性属于可在电池中存储能量并可能充电的设备，或可为其他设备充电的设备。

设备属性

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

属性	类型	说明
queryOnlyEnergyStorage	布尔值	必填。 如果此设备仅支持查询存储的能量级别，并且可以选择性地查询主动充电状态（取决于 isRechargeable 属性），但不支持开始和停止充电，则为 true。
energyStorageDistanceUnitForUX	String	（默认值："KILOMETERS"） 将用于向用户发送的响应。 支持的值： KILOMETERS MILES
isRechargeable	布尔值	（默认值：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	数组	包含设备充满电之前的容量信息的单位/值对数组。例如：<设备>充满电之前还有多少时间 。
[item, ...]	对象	充电前的容量。
rawValue	整数	必填。 容量值。
unit	String	必填。 容量单位。 支持的值： SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	布尔值	设备是否正在充电。
isPluggedIn	布尔值	设备是否已接通电源。设备可以接通电源，但不会主动充电。

示例

可充电设备

{
  "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	布尔值	必填。 true 表示开始充电，false 表示停止充电。

示例

开始充电命令

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

停止充电命令

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

设备错误

查看 错误和异常的完整列表。

deviceUnplugged：用户尝试为未接通电源的设备充电。