智能家居 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
}

设备状态

具有此特征的实体可能会报告以下内容 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	布尔值	设备当前是否正在充电。
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：用户尝试为未插入电源的设备充电。