Умный дом StatusReport Trait Schema

action.devices.traits.StatusReport — этот трейт сообщает о текущем состоянии определенного устройства или подключенной группы устройств.

Конкретное устройство может сообщать о своем текущем состоянии, а также о состоянии любых связанных устройств в группе. Например, целевым устройством может быть система безопасности, а связанные с ней устройства представляют собой отдельные датчики. StatusReport служит агрегированием для сообщения о коллективном статусе, но не заменяет индивидуальную адресацию. Любое устройство, к которому может получить доступ Google Assistant, должно быть указано как отдельное устройство в ответе SYNC .

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

Никто.

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

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

состояния Тип Описание
currentStatusReport Множество

Необходимый.

Текущие статусы ошибок или исключений устройства и любые связанные идентификаторы устройств.

[ item, ... ] Объект

Текущее состояние.

blocking логический

Истинно, если ошибка или текущий статус блокируют дальнейшее выполнение команд.

deviceTarget Нить

Идентификатор целевого устройства.

priority Целое число

Определяет приоритет этого состояния. Чем ниже значение, тем выше приоритет, при этом наивысший приоритет равен 0. Google сообщает статус ошибки или исключения от самого высокого к самому низкому приоритету. В зависимости от поверхности Google может сообщать только об ошибках или исключениях с высоким приоритетом.

statusCode Нить

Текущее состояние устройства. См. полный список ошибок и исключений .

Примеры

В порядке ли моя система безопасности?

{
  "currentStatusReport": [
    {
      "blocking": false,
      "deviceTarget": "alarm_1",
      "priority": 0,
      "statusCode": "lowBattery"
    },
    {
      "blocking": false,
      "deviceTarget": "front_window_1",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": false,
      "deviceTarget": "back_window_2",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": true,
      "deviceTarget": "alarm_2",
      "priority": 0,
      "statusCode": "needsSoftwareUpdate"
    }
  ]
}

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

Никто.

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

См. полный список ошибок и исключений .