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 level_synonym e lang.
[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 availableArmLevels for especificado. Se houver vários níveis de segurança, indica o nome do nível de segurança atual.
exitAllowance	Número inteiro	Indica o tempo, em segundos, que o usuário precisa sair para que o currentArmLevel entre em vigor.

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 arm.

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 level_name para ligar.

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

Dispositivo ERRORS

Veja a lista completa de erros e exceções.