Esquema de atributo de ativação/desativação da casa inteligente

action.devices.traits.ArmDisarm: essa característica oferece suporte a ativação e desativação, como em sistemas de segurança.

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 o processamento de intents SYNC, consulte Fulfillment de intents.

Atributos	Tipo	Descrição
availableArmLevels	Object	Descreve os níveis de segurança compatíveis com o dispositivo. Se esse atributo não for informado, o dispositivo só terá suporte a um nível.
levels	Array	Obrigatório. Lista dos níveis de segurança disponíveis com suporte do 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 pode não ser amigável ao usuário 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 com suporte. O primeiro item é tratado como o nome canônico.
[item, ...]	String	Nome do sinônimo.
lang	String	Obrigatório. Código do idioma para os sinônimos de nível. Consulte Idiomas aceitos.
ordered	Booleano	Obrigatório. Se definido como "true", a gramática adicional para a lógica de aumento/diminuição é aplicada na ordem da matriz de níveis. Por exemplo, "Ok Google, aumente meu nível de segurança em 1" faz com que o Google Assistente determine o nível de segurança atual e aumente esse nível em um. Se esse valor for definido como "false", não haverá suporte para gramática adicional para a lógica de aumento/diminuição.

Exemplos

Sistema de segurança com dois níveis de ativação 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
  }
}

ESTADOS DO DISPOSITIVO

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Estados	Tipo	Descrição
isArmed	Booleano	Obrigatório. Indica se o dispositivo está ativado.
currentArmLevel	String	Obrigatório. Obrigatório se o atributo availableArmLevels for especificado. Se houver vários níveis de segurança, indique o nome do nível atual.
exitAllowance	Número inteiro	Indica o tempo, em segundos, que o usuário tem para sair antes que currentArmLevel entre em vigor.

Exemplos

Sistema de segurança que informa o nível de ativação

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

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

action.devices.commands.ArmDisarm

Define o nível de alarme deste dispositivo.

Parâmetros

O payload contém uma das seguintes opções:

Cancelar a operação de ativação ou desativação

Parâmetros	Tipo	Descrição
followUpToken	String	Token fornecido pelo Google para a resposta de acompanhamento.
arm	Booleano	Obrigatório. Verdadeiro quando o comando é para ativar. Falso para desativar.
cancel	Booleano	Obrigatório. Verdadeiro quando o comando é cancelar o valor arm.

Ativar ou desativar o dispositivo com um nível de segurança opcional.

Parâmetros	Tipo	Descrição
followUpToken	String	Token fornecido pelo Google para a resposta de acompanhamento.
arm	Booleano	Obrigatório. Verdadeiro quando o comando é para ativar. Falso para desativar.
armLevel	String	O level_name a ser ativado.

Exemplos

Ativar o sistema

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

Definir o sistema para o nível de ativação 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 ativar ou desativar o dispositivo.

Valores aceitos:

alreadyInState

deviceTampered

passphraseIncorrect

pinIncorrect

securityRestriction

tooManyFailedAttempts

userCancelled

ERROS do dispositivo

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