Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.

Схема признаков умного дома EnergyStorage

action.devices.traits.EnergyStorage — эта черта относится к устройствам, которые могут накапливать энергию в батарее и потенциально перезаряжаться, или устройствам, которые могут заряжать другое устройство.

АТРИБУТЫ устройства

Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты Тип Описание
queryOnlyEnergyStorage логический

Необходимый.

Значение true, если это устройство поддерживает только запросы об уровнях сохраненной энергии и, при необходимости, об активном состоянии зарядки (в зависимости от атрибута isRechargeable ), но не поддерживает запуск и остановку зарядки.

energyStorageDistanceUnitForUX Нить

(По умолчанию: "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 см. в разделе Выполнение намерений .

состояния Тип Описание
descriptiveCapacityRemaining Нить

Необходимый.

Качественное описание уровня энергоемкости. Обратите внимание, что это для случаев, когда нет числовых данных о емкости. Если также доступны числовые данные о емкости, они будут предпочтительнее описательных, когда это возможно.

Поддерживаемые значения:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Множество

Массив пар единиц/значений, содержащих информацию об энергоемкости устройства в данный момент. Например: сколько миль в настоящее время у моего <устройства> или какой процент заряда есть у моего <устройства>.

[ item, ... ] Объект

Оставшаяся мощность в паре единиц и значений.

rawValue Целое число

Необходимый.

Значение емкости.

unit Нить

Необходимый.

Единица емкости.

Поддерживаемые значения:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Множество

Массив пар единиц/значений, содержащих информацию о емкости до полной зарядки устройства. Например: Сколько времени осталось до полной зарядки <устройства> .

[ item, ... ] Объект

Емкость пока не заряжена.

rawValue Целое число

Необходимый.

Значение емкости.

unit Нить

Необходимый.

Единица емкости.

Поддерживаемые значения:

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 см. в разделе Выполнение намерений .

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 : пользователь пытался зарядить устройство, которое не подключено к сети.