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