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