Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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
  }
}

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.