Схема типа StartStop для умного дома

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

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

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

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

Атрибуты устройств

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

Атрибуты Тип Описание
pausable Логическое значение

(по умолчанию: false)

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

Указывает названия поддерживаемых зон. Строки должны быть локализованы в соответствии с настройками пользователя. Этот список не является исчерпывающим. Пользователи могут сообщать о любых именах.
[item, ...] String

Название зоны, в которой поддерживается устройство, запускающее автоматизацию.

Примеры

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

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

Состояния устройств

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

Штаты Тип Описание
isRunning Логическое значение

Обязательно.

Указывает, работает ли устройство в данный момент.
isPaused Логическое значение

Указывает, приостановлено ли устройство явным образом. Если это значение равно true, то isRunning равно false, но может быть возобновлено. Это поле не должно существовать, если атрибут pausable имеет значение false.
activeZones Array

Указывает зоны, в которых в настоящее время работает устройство, из списка availableZones.
[item, ...] String

Название зоны.

Примеры

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

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

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

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

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

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

Команды для устройств

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

action.devices.commands.StartStop

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

Параметры

Параметры Тип Описание
start Логическое значение

Обязательно.

True, чтобы запустить устройство, false, чтобы остановить.
zone String

Указывает зону, в которой нужно начать бег.
multipleZones Array

Указывает две или более зон, в которых нужно начать бег. Будет установлено вместо zone parameter.
[item, ...] String

Название зоны, в которой нужно запустить устройство.

Примеры

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

{
  "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
}

Параметры

Параметры Тип Описание
pause Логическое значение

Обязательно.

True – приостановить, false – возобновить.

Примеры

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

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

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

Допустимые значения:

unpausableState

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

de-DE

  • Bitte starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット を リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern på gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

Ошибки устройства

Ознакомьтесь с полным списком ошибок и исключений.