欢迎使用 Google Home 开发者中心,您可以在这里学习有关如何开发智能家居 Action 的新平台。注意:你将继续在 Actions 控制台中构建操作。
使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

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

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

设备属性

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

属性 类型 说明
queryOnlyEnergyStorage Boolean

必填。

如果此设备仅支持对存储的电量水平和(可选)主动充电状态(具体取决于 isRechargeable 属性)的查询,但不支持查询,则不支持开始和停止充电。

energyStorageDistanceUnitForUX String

(默认值:"KILOMETERS"

将在对用户的回复中使用。

支持的值:

KILOMETERS
MILES
isRechargeable Boolean

(默认值:false

如果此设备可充电,则设置为 true。这表示设备可以报告 capacityUntilFullisCharging 以及可选的 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:用户尝试对未接通电源的设备进行充电。