Esta é a Central do desenvolvedor do Google Home, o novo destino para aprender a desenvolver ações de casa inteligente. Observação:você continuará criando ações no Console do Actions.

Esta página foi traduzida pela API Cloud Translation.

Esquema de traços de OpenClose da casa inteligente

action.devices.traits.OpenClose: essa característica pertence a dispositivos que permitem abrir e fechar e, em alguns casos, abrir e fechar parcial ou potencialmente em mais de uma direção.

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos	Tipo	Descrição
`discreteOnlyOpenClose`	Booleano	Padrão: `false`. Quando definido como verdadeiro, isso indica que o dispositivo precisa estar totalmente aberto ou totalmente fechado (ou seja, não é compatível com 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 permitir abertura e fechamento em mais de uma direção.
`[item, ...]`	String	Direção aceita. Valores compatíveis: `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 de CONSULTA ou ao estado do 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 simples e aberto e fechado.

{
  "discreteOnlyOpenClose": true
}

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

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

Dispositivo somente para comando.

{
  "commandOnlyOpenClose": false
}

STATES do dispositivo

Entidades com essa característica podem relatar o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

O payload contém um dos seguintes itens:

Abertura e fechamento unidirecional

Estados Tipo Descrição

Estados	Tipo	Descrição
`openPercent`	Número	Obrigatório. Indica a porcentagem de abertura de um dispositivo, em que 0 está fechado e 100 é totalmente aberto.
`targetOpenPercent`	Número	Nível que indica a porcentagem de abertura para onde o dispositivo irá ou está se movendo como resultado de uma mudança contínua de posição.

openPercent

Número

Obrigatório.

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

targetOpenPercent

Número

Nível que indica a porcentagem de abertura para onde o dispositivo irá ou está se movendo como resultado de uma mudança contínua de posição.

Abertura e fechamento em 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 de abertura de um dispositivo, em que 0 está fechado e 100 é totalmente aberto.
`targetOpenPercent`	Número	Nível que indica a porcentagem de abertura para onde o dispositivo irá ou está se movendo como resultado de uma mudança contínua de posição.
`openDirection`	String	Obrigatório. Direção em que o dispositivo é aberto. Valores compatíveis: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Exemplos

Dispositivo simples e aberto e fechado.

{
  "openPercent": 100
}

Dispositivo simples, aberto e fechado, abrindo para uma nova posição.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

Abra o dispositivo em 30% para baixo e 50% para cima.

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

Abra o dispositivo em 30% para baixo e 50% para cima, atualmente movendo 80% para cima.

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

COMANDOS DO dispositivo

Dispositivos com essa característica podem responder ao seguinte como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Fulfillment da intent.

`action.devices.commands.OpenClose`

Define o estado aberto e fechado do dispositivo.

Parâmetros

Parâmetros Tipo Descrição

Parâmetros	Tipo	Descrição
`openPercent`	Número	Obrigatório. Indica a porcentagem de abertura de um dispositivo, em que 0 está fechado e 100 é totalmente aberto.
`openDirection`	String	Direção de abertura. Presente apenas se o dispositivo oferecer suporte a várias direções, conforme indicado pelo atributo `openDirection`, e uma direção for especificada pelo usuário. Valores compatíveis: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	Token fornecido pelo Google para resposta de acompanhamento.

openPercent

Número

Obrigatório.

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

openDirection

String

Direção de abertura. Presente apenas se o dispositivo oferecer suporte a várias direções, conforme indicado pelo atributo openDirection, e uma direção for especificada pelo usuário.

Valores compatíveis:

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 50% abaixo.

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

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

Valores compatíveis:

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 a implementação de 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

Campos	Tipo	Descrição
`followUpToken`	String	Obrigatório. Token fornecido na solicitação EXECUTE original.
`status`	String	Obrigatório. Resultado da solicitação. Valores compatíveis: `SUCCESS`
`openPercent`	Número	Obrigatório. Indica a porcentagem de que um dispositivo é aberto onde 0 está fechado e 100 é totalmente aberto.

followUpToken

String

Obrigatório.

Token fornecido na solicitação EXECUTE original.

status

String

Obrigatório.

Resultado da solicitação.

Valores compatíveis:

SUCCESS

openPercent

Número

Obrigatório.

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

Falha

Campos Tipo Descrição

Campos	Tipo	Descrição
`followUpToken`	String	Obrigatório. Token fornecido na solicitação EXECUTE original.
`status`	String	Obrigatório. Resultado da solicitação. Valores compatíveis: `FAILURE`
`errorCode`	String	Obrigatório. O valor pode ser qualquer código de erro para essa característica, por exemplo, `lockedState`.

followUpToken

String

Obrigatório.

Token fornecido na solicitação EXECUTE original.

status

String

Obrigatório.

Resultado da solicitação.

Valores compatíveis:

FAILURE

errorCode

String

Obrigatório.

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

Exemplos

Abra o portão da garagem. (resposta de acompanhamento para caso de sucesso)

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

Abra o portão da garagem. (resposta de acompanhamento para caso de falha)

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

`action.devices.commands.OpenCloseRelative`

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

Esse comando requer os seguintes atributos:

{
  "commandOnlyOpenClose": false
}

Parâmetros

Parâmetros Tipo Descrição

Parâmetros	Tipo	Descrição
`openRelativePercent`	Número	Obrigatório. A porcentagem exata para alterar o estado aberto/fechado. Comandos relativos amplos serão convertidos em um parâmetro de porcentagem exato (por exemplo, "Abrir as cortinas um pouco mais" em vez de "Abrir as cortinas em 5%").
`openDirection`	String	Direção de abertura. Presente apenas se o dispositivo oferecer suporte a várias direções, conforme indicado pelo atributo `openDirection`, e uma direção for especificada pelo usuário. Valores compatíveis: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Número

Obrigatório.

A porcentagem exata para alterar o estado aberto/fechado. Comandos relativos amplos serão convertidos em um parâmetro de porcentagem exato (por exemplo, "Abrir as cortinas um pouco mais" em vez de "Abrir as cortinas em 5%").

openDirection

String

Direção de abertura. Presente apenas se o dispositivo oferecer suporte a várias direções, conforme indicado pelo atributo openDirection, e uma direção for especificada pelo usuário.

Valores compatíveis:

UP
DOWN
LEFT
RIGHT
IN
OUT

Exemplos

Abra um pouco mais o dispositivo

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

Fechar o dispositivo mais 10%

{
  "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 abertura/fechamento do dispositivo.

Valores compatíveis:

lockedState
deviceJammingDetected

Exemplos de declarações

de-DE

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

en-US

Are the blinds in the kitchen open
Close the blinds 25% in my room
Close the door more
Just close the front door
open the blinds in my room
open the blinds to 25%
open the door by 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
está abierta la puerta
quiero que subas la persiana al 25%
sube un 20% las persianas

fr-FR

baisse les stores de 10%
est-ce que la porte d'entrée est ouverte
ferme les stores
ferme un peu les stores
ouvre les stores
ouvre les stores de la chambre de 25%
ouvre les stores à 25%

hi-IN

कृपया 25% पर्दे को खुला रखो
क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
पर्दे को 25% बंद करोगे
पर्दे खोलो
ब्लाइंड 25% खुले पर सेट कर दीजिए
ब्लाइंड को थोड़ा और बंद कर दिजिए
ब्लाइंड बंद करें

it-IT

abbassa un po' di più le tapparelle
apri la serranda
apri la tapparella al 30%
apri le serrande del 30%
chiudi le serrande
chiudi le tende del 25%
è aperta la porta d'ingresso

ja-JP

25% に ブラインド を開けて
25% ブラインド を閉めてください
25% ブラインド 開けて
ブラインド 閉めて
ブラインド 開けて
少し ブラインド を閉じて
玄関のドア は開いてますか

ko-KR

문 살짝만 닫아 줘
블라인드 25% 열어 줘
블라인드 25% 까지 열어 줘
블라인드 30프로 닫아
블라인드 닫아 줘
블라인드 열어 줘
안방 문 열렸어

nl-NL

doe de gordijnen 25% open
doe de jaloezieën voor 25% dicht
doe het raam ietsje meer dicht
is de voordeur open
open de gordijnen
sluit het gordijn
zet de luxaflex voor 50% open

pt-BR

Abrir janela 50%
As cortinas estão abertas?
Fecha a persiana toda
Fechar a janela 10%
a cortina do quarto está aberta?
abra a persiana até 30%
abre as cortinas
abre as cortinas a 50%
abrir as cortinas
abrir as cortinas na sala em 30%
fecha a persiana por favor
fecha um bocado a janela
fechar as cortinas em 25%
fechar um pouco mais as cortinas

sv-SE

Dra upp persiennerna
Dra upp persiennerna till 25%
stäng persiennen i mitt rum 25%
stäng persiennerna
är ytterdörren öppen?
öppna persiennerna med 25%

ERROS no dispositivo

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

Esquema de traços de OpenClose da casa inteligente

ATRIBUTOS DO dispositivo

Exemplos

STATES do dispositivo

Abertura e fechamento unidirecional

Abertura e fechamento em várias direções

Exemplos

COMANDOS DO dispositivo

action.devices.commands.OpenClose

Parâmetros

Exemplos

Erros relacionados

Respostas de acompanhamento

Sucesso

Falha

Exemplos

action.devices.commands.OpenCloseRelative

Parâmetros

Exemplos

Erros relacionados

Exemplos de declarações

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

ERROS no dispositivo

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`