Схема свойств StartStop для умного дома

action.devices.traits.StartStop — эта черта принадлежит устройствам, поддерживающим запуск и остановку операций.

Запуск и остановка устройства выполняют ту же функцию, что и его включение и выключение. Устройства, унаследовавшие эту особенность, функционируют по-разному при включении и запуске. Например, некоторые стиральные машины можно включить и изменить настройки перед фактическим началом работы.

В отличие от устройств, которые просто имеют состояние «включено» и «выключено», некоторые устройства, которые могут запускаться и останавливаться, также могут приостанавливать выполнение операции. Устройства, которые могут поставить на паузу, прекратят работу, но при возобновлении работы продолжат работу в том же состоянии, в котором они были приостановлены. Снятие с паузы отличается от запуска/перезапуска тем, что независимо от текущего состояния устройства работа начнется сначала.

Некоторые устройства могут поддерживать работу в определенных зонах. Например, спринклер может иметь различные зоны полива и поддерживать возможность полива определенных зон отдельно, тогда как пылесос может поддерживать уборку определенных помещений.

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

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

Примеры

Устройство, которое можно приостанавливать и поддерживает работу в нескольких зонах.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

СОСТОЯНИЯ устройства

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

Примеры

Устройство приостановлено?

{
  "isRunning": false,
  "isPaused": true
}

Устройство приостановлено?

{
  "isRunning": true,
  "isPaused": false
}

Устройство работает?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

КОМАНДЫ устройства

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

action.devices.commands.StartStop

Запустите или остановите устройство.

Параметры

Примеры

Запустите устройство.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Остановите устройство.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Запустите устройство в офисе.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Запустите устройство на кухне, в столовой и гостиной.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "Kitchen",
      "Dining room",
      "Living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Приостановить или возобновить работу устройства.

{
  "pausable": true
}

Параметры

Примеры

Приостановите работу устройства.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

Связанные ошибки

Пользователь попытался приостановить работу устройства, но устройство находится в состоянии, в котором его невозможно приостановить.

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

unpausableState

Примеры высказываний

ОШИБКИ устройства