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