Esquema de características do Smart Arm ArmSisarm
action.devices.traits.ArmDisarm
: essa característica oferece suporte ao disparo e ao desligamento, conforme usado em sistemas de segurança, por exemplo.
Para dispositivos com vários níveis de segurança, esses níveis precisam ser informados com o
atributo availableArmLevels
.
ATRIBUTOS DO DISPOSITIVO
Dispositivos com essa característica podem informar os seguintes
atributos como parte da operação SYNC
. Para saber
mais sobre como processar intents SYNC
, consulte
fulfillment de intent.
Atributos | Tipo | Descrição |
---|---|---|
availableArmLevels |
Object |
Descreve os níveis de segurança com suporte do dispositivo. Se esse atributo não for informado, o dispositivo oferece suporte a apenas um nível. |
levels |
Array |
Obrigatório. Lista dos níveis de segurança disponíveis no dispositivo. |
[item, ...] |
Object |
Nível de segurança. |
level_name |
String |
Obrigatório. O nome interno do nível de segurança usado em comandos e estados. Esse nome não é fácil de usar e é compartilhado em todos os idiomas. |
level_values |
Array |
Obrigatório. Contém |
[item, ...] |
Object |
Sinônimo de nível para um determinado idioma. |
level_synonym |
Array |
Obrigatório. Nomes fáceis de usar para o nível em cada idioma aceito. O primeiro item é tratado como o nome canônico. |
[item, ...] |
String |
Nome de sinônimo. |
lang |
String |
Obrigatório. Código do idioma para os sinônimos de nível. Consulte Idiomas compatíveis. |
ordered |
Booleano |
Obrigatório. Se definida como verdadeira, a gramática adicional para lógica de aumento/diminuição será aplicada, na ordem da matriz de níveis. Por exemplo, "Ok Google, aumente meu nível de segurança em 1" para que o Google Assistente determine o nível de segurança atual e depois aumente o nível em um. Se o valor for definido como "false" (falso), não será possível usar gramática adicional para lógica de aumento/diminuição. |
Exemplos
Sistema de segurança com dois níveis de grupos 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 } }
STATES do dispositivo
Entidades com essa característica podem relatar os estados
a seguir como parte da operação QUERY
. Para saber
mais sobre como processar intents QUERY
, consulte
fulfillment de intent.
Estados | Tipo | Descrição |
---|---|---|
isArmed |
Booleano |
Obrigatório. Indica se o dispositivo está ligado. |
currentArmLevel |
String |
Obrigatório. Obrigatório se o atributo |
exitAllowance |
Número inteiro |
Indica o tempo, em segundos, que o usuário precisa sair para que o |
Exemplos
Sistema de segurança que indica diferentes níveis de braço
{ "isArmed": true, "currentArmLevel": "L1" }
Comandos do dispositivo
Dispositivos com essa característica podem responder aos seguintes
comandos como parte da operação EXECUTE
. Para saber
mais sobre como processar intents EXECUTE
, consulte
fulfillment de intent.
action.devices.commands.ArmDisarm
Defina o nível de alarme deste dispositivo.
Parâmetros
O payload contém um dos seguintes itens:
Cancelar a operação de ligar ou desligar
Parâmetros | Tipo | Descrição |
---|---|---|
followUpToken |
String |
Token fornecido pelo Google para resposta de acompanhamento. |
arm |
Booleano |
Obrigatório. Verdadeiro quando o comando é para ligar. Falso para desligar. |
cancel |
Booleano |
Obrigatório. Verdadeiro quando o comando é para cancelar o valor |
Ligar ou desligar o dispositivo, com um nível de segurança opcional.
Parâmetros | Tipo | Descrição |
---|---|---|
followUpToken |
String |
Token fornecido pelo Google para resposta de acompanhamento. |
arm |
Booleano |
Obrigatório. Verdadeiro quando o comando é para ligar. Falso para desligar. |
armLevel |
String |
O |
Exemplos
Ativar o sistema
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
Definir o sistema para o nível L1
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Cancelar a operação de ativação
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
Erros relacionados
Ocorreu um erro ao ligar ou desligar o dispositivo.
Os valores suportados são:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled