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

action.devices.traits.ArmDisarm — эта черта поддерживает постановку и снятие с охраны, например, в системах безопасности.

Для устройств с несколькими уровнями безопасности об этих уровнях следует сообщать с помощью атрибута availableArmLevels .

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

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

Атрибуты Тип Описание
availableArmLevels Объект

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

levels Множество

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

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

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

Уровень безопасности.

level_name Нить

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

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

level_values Множество

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

Содержит level_synonym и lang .

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

Синоним уровня для данного языка.

level_synonym Множество

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

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

[ item, ... ] Нить

Название-синоним.

lang Нить

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

Код языка для синонимов уровня. См. Поддерживаемые языки .

ordered логическое значение

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

Если установлено значение true, применяется дополнительная грамматика для логики увеличения/уменьшения в порядке массива уровней. Например, фраза «Окей, Google, повысь мой уровень безопасности на 1» приводит к тому, что Ассистент определяет текущий уровень безопасности, а затем повышает его на единицу. Если для этого значения установлено значение false, дополнительная грамматика для логики увеличения/уменьшения не поддерживается.

Примеры

Система безопасности с двумя отдельными уровнями рычагов

{
  "availableArmLevels": {
    "levels": [
      {
        "level_name": "L1",
        "level_values": [
          {
            "level_synonym": [
              "Home and Guarding",
              "SL1"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Zuhause und Bewachen",
              "SL1"
            ],
            "lang": "de"
          }
        ]
      },
      {
        "level_name": "L2",
        "level_values": [
          {
            "level_synonym": [
              "Away and Guarding",
              "SL2"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Weg und Bewachen",
              "SL2"
            ],
            "lang": "de"
          }
        ]
      }
    ],
    "ordered": true
  }
}

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

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

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

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

Указывает, поставлено ли устройство на охрану.

currentArmLevel Нить

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

Требуется, если указан атрибут availableArmLevels . Если существует несколько уровней безопасности, указывает имя текущего уровня безопасности.

exitAllowance Целое число

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

Примеры

Система безопасности, которая сообщает об определенном уровне рычага

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

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

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

action.devices.commands.ArmDisarm

Установите уровень тревоги этого устройства.

Параметры

Полезная нагрузка содержит одно из следующего:

Отменить операцию постановки или снятия с охраны

Параметры Тип Описание
followUpToken Нить

Токен, предоставленный Google для последующего ответа.

arm логическое значение

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

Истинно, когда команда должна поставить на охрану. Ложь для снятия с охраны.

cancel логическое значение

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

Истинно, когда команда предназначена для отмены значения arm .

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

Параметры Тип Описание
followUpToken Нить

Токен, предоставленный Google для последующего ответа.

arm логическое значение

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

Истинно, когда команда должна поставить на охрану. Ложь для снятия с охраны.

armLevel Нить

level_name для постановки на охрану.

Примеры

Поставьте систему на охрану

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

Установите систему на уровень охраны L1.

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

Отменить постановку на охрану

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

Произошла ошибка при постановке или снятии устройства с охраны.

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

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

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

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