Схема признаков умного дома 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

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

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

Схема признаков умного дома 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

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

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

Схема признаков умного дома 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

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

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

Схема признаков умного дома 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

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

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