Esquema de la función ArmArmarm para casa inteligente
action.devices.traits.ArmDisarm
: Esta característica admite la activación y desactivación como se usa en los sistemas de seguridad, por ejemplo.
En el caso de los dispositivos con varios niveles de seguridad, se deben informar estos niveles con el atributo availableArmLevels
.
ATRIBUTOS DEL Dispositivo
Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo manejar los intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
availableArmLevels |
Objeto |
Describe los niveles de seguridad admitidos del dispositivo. Si no se informa este atributo, el dispositivo solo admite un nivel. |
levels |
Matriz |
Obligatorio. Lista de los niveles de seguridad disponibles que admite el dispositivo. |
[item, ...] |
Objeto |
Nivel de seguridad. |
level_name |
String |
Obligatorio. El nombre interno del nivel de seguridad que se usa en los comandos y estados. Este nombre puede ser poco fácil de usar y se comparte en todos los idiomas. |
level_values |
Matriz |
Obligatorio. Contiene |
[item, ...] |
Objeto |
Sinónimo de nivel para un idioma determinado. |
level_synonym |
Matriz |
Obligatorio. Nombres fáciles de usar para el nivel en cada idioma admitido. El primer elemento se trata como el nombre canónico. |
[item, ...] |
String |
Nombre del sinónimo. |
lang |
String |
Obligatorio. Código de idioma para los sinónimos de nivel Consulta Idiomas compatibles. |
ordered |
Booleano |
Obligatorio. Si se establece como verdadera, se aplicará una gramática adicional para la lógica de aumento o disminución, en el orden de la matriz de niveles. Por ejemplo, si dices "Hey Google, aumenta mi nivel de seguridad en 1", Asistente hará que determine el nivel de seguridad actual y lo aumente en uno. Si este valor se establece en false, no se admiten gramáticas adicionales para la lógica de aumento o disminución. |
Ejemplos
Sistema de seguridad con dos niveles de brazo distintos
{ "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 } }
Dispositivo STATEs
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre cómo manejar los intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
isArmed |
Booleano |
Obligatorio. Indica si el dispositivo está activado en este momento. |
currentArmLevel |
String |
Obligatorio. Obligatorio si se especifica el atributo |
exitAllowance |
Número entero |
Indica la hora, en segundos, que el usuario debe abandonar antes de que |
Ejemplos
Sistema de seguridad que informa el nivel de protección distinto
{ "isArmed": true, "currentArmLevel": "L1" }
Dispositivo COMMAND
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo manejar los intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.ArmDisarm
Establece el nivel de alarma de este dispositivo.
Parámetros
La carga útil contiene una de las siguientes opciones:
Cómo cancelar la activación o desactivación de la operación
Parámetros | Tipo | Descripción |
---|---|---|
followUpToken |
String |
Token proporcionado por Google para la respuesta de seguimiento |
arm |
Booleano |
Obligatorio. Verdadero cuando el comando es activar. Falso para desactivar la alarma. |
cancel |
Booleano |
Obligatorio. Verdadero cuando el comando es cancelar el valor |
Activa o desactiva el dispositivo con un nivel de seguridad opcional.
Parámetros | Tipo | Descripción |
---|---|---|
followUpToken |
String |
Token proporcionado por Google para la respuesta de seguimiento |
arm |
Booleano |
Obligatorio. Verdadero cuando el comando es activar. Falso para desactivar la alarma. |
armLevel |
String |
La |
Ejemplos
Activa el sistema
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
Configurar el sistema en el nivel de activación L1
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Cancelar la operación de activación
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
Errores relacionados
Se produjo un error al activar o desactivar el dispositivo.
Valores admitidos:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled