智能家居 EnergyStorage 特征架构

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
}

设备状态

具有此 trait 的实体可能会在 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	布尔值	设备当前是否正在充电。
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"
}

设备命令

具有此 trait 的设备可能会在 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：用户尝试为未插入电源的设备充电。