Схема признаков RunCycle умного дома

action.devices.traits.RunCycle — этот признак представляет любое устройство, работа которого имеет непрерывную продолжительность, и которую можно запросить.

Подобные устройства сообщают об общем количестве циклов в начале работы и о каждом цикле, в котором устройство находится в данный момент во время работы. Это позволяет пользователю делать запросы, например:

• На каком цикле работает моя сушильная машина?
• Сколько циклов осталось посудомоечной машине?
• Что делает сушилка?
• Когда будет стирка?

Некоторые устройства включают продолжительность в нециклическом формате. Любое устройство, работающее определенное время, может сообщать об оставшемся времени без циклов. Это также учитывает случаи, когда циклы могут быть непоследовательными (например, посудомоечные машины не всегда могут использовать все циклы). Например, пользователь может спросить: «Как долго еще будет работать мой пылесос?» который вернет количество времени в единицах, пропорциональное оставшемуся времени. Это касается и перечисленных выше устройств; Как долго моя одежда будет сохнуть? вернет продолжительность в минутах.

Устройства могут возвращать то, что им известно, и ответ TTS Ассистента сформирует лучший ответ с учетом доступных данных (например, Посудомоечная машина работает и завершится примерно через 20 минут).

RunCycle в настоящее время доступен только для чтения — у него нет команд, есть только состояния для запроса. В будущем могут появиться механизмы повторного запуска или пропуска циклов (хорошие для разбрызгивателей и плохие для стиральных машин).

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

Никто.

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

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

Примеры

Устройство ополаскивается еще 5 минут и будет готово через 20 минут.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

Устройство ополаскивается еще 5 минут, прежде чем перейти к отжиму.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

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

Никто.

УВЕДОМЛЕНИЯ УСТРОЙСТВА

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

Примеры

Устройство завершило работу.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

Произошла ошибка при завершении текущего цикла.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

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