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 OpenClose da casa inteligente

action.devices.traits.OpenClose: essa característica pertence a dispositivos compatíveis com abertura e fechamento e, em alguns casos, abertura e fechamento em mais de uma direção.

ATRIBUTOS DO DISPOSITIVO

Dispositivos com essa característica podem relatar 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
discreteOnlyOpenClose Booleano

Padrão: false.

Quando definido como "true", isso indica que o dispositivo precisa estar totalmente aberto ou totalmente fechado, ou seja, não oferece suporte a valores entre 0% e 100%.

openDirection Array

Lista de rotas compatíveis em que o dispositivo pode abrir ou fechar. Inclua esse atributo se o dispositivo oferecer suporte para abertura e fechamento em mais de uma direção.

[item, ...] String

Direção aceita.

Os valores suportados são:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Booleano

Padrão: false.

Indica se o dispositivo suporta o uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou a um estado de relatório para essa característica.

queryOnlyOpenClose Booleano

Padrão: false.

Indica se o dispositivo só pode ser consultado para informações de estado e não pode ser controlado. Os sensores que só podem informar o estado aberto precisam definir esse campo como "true".

Exemplos

Dispositivo de fechamento simples.

{
  "discreteOnlyOpenClose": true
}

Dispositivo de cima para baixo e de baixo para cima. pode ser aberto em qualquer direção.

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

Dispositivo somente comando:

{
  "commandOnlyOpenClose": true
}

STATES do dispositivo

Dispositivos com essa característica podem informar os estados a seguir como parte da operação QUERY. Para saber mais sobre como processar intents QUERY, consulte fulfillment de intent.

O payload contém um dos seguintes itens:

Fechamento único de direção única

Estados Tipo Descrição
openPercent Número

Obrigatório.

Indica a porcentagem que um dispositivo está aberto, em que 0 é fechado e 100 é totalmente aberto.

Fechamento de várias direções

Estados Tipo Descrição
openState Array

Obrigatório.

Lista de estados para cada direção aberta suportada.

[item, ...] Object

Estado atual da direção aberta especificada.

openPercent Número

Obrigatório.

Indica a porcentagem que um dispositivo está aberto, em que 0 é fechado e 100 é totalmente aberto.

openDirection String

Obrigatório.

É a direção em que o dispositivo é aberto.

Os valores suportados são:

UP
DOWN
LEFT
RIGHT
IN
OUT

Exemplos

Dispositivo de fechamento simples.

{
  "openPercent": 100
}

Abra o dispositivo 30% na direção para baixo e 50% na direção para cima.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

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

Define o estado de fechamento do dispositivo.

Parâmetros

Parâmetros Tipo Descrição
openPercent Número

Obrigatório.

Indica a porcentagem que um dispositivo está aberto, em que 0 é fechado e 100 é totalmente aberto.

openDirection String

Direção na qual abrir. Presente somente se o dispositivo for compatível com várias direções, conforme indicado pelo atributo openDirection, e se uma rota for especificada pelo usuário.

Os valores suportados são:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Token fornecido pelo Google para resposta de acompanhamento.

Exemplos

Abra o dispositivo.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

Abra o dispositivo com 50% de desconto.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

Ocorreu um erro ao configurar o estado de fechamento do dispositivo.

Os valores suportados são:

lockedState
deviceJammingDetected

Respostas de acompanhamento

Dispositivos com essa característica podem retornar o seguinte payload de resposta de acompanhamento como parte da operação EXECUTE. Para saber mais sobre como implementar respostas de acompanhamento, consulte Notificações de ações de casa inteligente.

O payload contém um dos seguintes itens:

Sucesso

Campos Tipo Descrição
followUpToken String

Obrigatório.

Token fornecido na solicitação EXECUTE original.

status String

Obrigatório.

Resultado da solicitação.

Os valores suportados são:

SUCCESS
openPercent Número

Obrigatório.

Indica a porcentagem em que um dispositivo está aberto, em que 0 é fechado e 100 é totalmente aberto.

Falha

Campos Tipo Descrição
followUpToken String

Obrigatório.

Token fornecido na solicitação EXECUTE original.

status String

Obrigatório.

Resultado da solicitação.

Os valores suportados são:

FAILURE
errorCode String

Obrigatório.

O valor pode ser qualquer código de erro dessa característica, por exemplo, lockedState.

Exemplos

Abra a porta da garagem. (resposta de acompanhamento do caso de sucesso)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

Abra a porta da garagem. (resposta de acompanhamento do caso de falha)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

Ajuste o estado de fechamento do dispositivo em relação ao estado atual. Esse comando só estará disponível se commandOnlyOpenClose estiver definido como true.

Esse comando requer os seguintes atributos:
{
  "commandOnlyOpenClose": true
}

Parâmetros

Parâmetros Tipo Descrição
openRelativePercent Número

Obrigatório.

A porcentagem exata para mudar o estado de fechamento. Comandos relativos amplos são convertidos em um parâmetro de porcentagem exata (por exemplo, "Abra as cortinas um pouco mais" em vez de "Abrir as cortinas em 5%)).

openDirection String

Direção na qual abrir. Presente somente se o dispositivo for compatível com várias direções, conforme indicado pelo atributo openDirection, e se uma rota for especificada pelo usuário.

Os valores suportados são:

UP
DOWN
LEFT
RIGHT
IN
OUT

Exemplos

Abrir o dispositivo um pouco mais

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

Fechar o dispositivo 10% mais

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

Abra o dispositivo 50% mais para baixo.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

Ocorreu um erro ao configurar o estado de fechamento do dispositivo.

Os valores suportados são:

lockedState
deviceJammingDetected

Exemplos de declarações

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25% schliessen
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Fechar persianas 25% in minha sala
  • Fechar a porta mais
  • Basta fechar A porta da frente
  • aberto persianas no quarto
  • aberto As cortinas para 25%
  • abrir a porta por 25%

es-ES

  • Abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • quiero que subas la persiana al 25%
  • sube 20% las persianas

fr-FR

  • baisse les stores de 10%
  • ferme lojas de los
  • ferme un peu les stores
  • ouvre lojas
  • ouvre les stores de la chambre de 25%
  • ouvre lojas à 25%

Dispositivo ERRORS

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