Схема характеристик системы хранения энергии для умного дома

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