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.

Switch to English

Esquema de traço do OpenClose da casa inteligente

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

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte fulfillment de 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 suportadas nas quais o dispositivo pode abrir ou fechar. Inclua este atributo se o dispositivo for compatível com abertura e fechamento em mais de uma direção.
`[item, ...]`	String	Direção suportada. 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 devem definir esse campo como "true".

Exemplos

Dispositivo de fechamento simples.

{
  "discreteOnlyOpenClose": true
}

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

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

Dispositivo somente comando.

{
  "commandOnlyOpenClose": false
}

STATES do dispositivo

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

O payload contém um dos seguintes itens:

Fechamento único de direção única

Estados Tipo Descrição

Estados	Tipo	Descrição
`openPercent`	Número	Obrigatório. Indica a porcentagem em que um dispositivo está aberto, em que 0 é fechado e 100 é totalmente aberto.

openPercent

Número

Obrigatório.

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

Fechamento aberto 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 em que um dispositivo está aberto, em que 0 é fechado e 100 é totalmente aberto.
`openDirection`	String	Obrigatório. Direção em que o dispositivo está 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"
    }
  ]
}

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

`action.devices.commands.OpenClose`

Define o estado de fechamento do dispositivo.

Parâmetros

Parâmetros Tipo Descrição

Parâmetros	Tipo	Descrição
`openPercent`	Número	Obrigatório. Indica a porcentagem em que um dispositivo está aberto, em que 0 é fechado e 100 é totalmente aberto.
`openDirection`	String	Direção da abertura. Presente somente se o dispositivo for compatível com várias direções, conforme indicado pelo atributo `openDirection`, e se a direção 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.

openPercent

Número

Obrigatório.

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

openDirection

String

Direção da abertura. Presente somente se o dispositivo for compatível com várias direções, conforme indicado pelo atributo openDirection, e se a direção 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 payload de resposta de acompanhamento a seguir como parte da operação EXECUTE. Para saber mais sobre como implementar respostas de acompanhamento, consulte Notificações para 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. Os valores suportados são: `SUCCESS`
`openPercent`	Número	Obrigatório. Indica a porcentagem em que um dispositivo é aberto, em que 0 é fechado e 100 é totalmente aberto.

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 é aberto, em que 0 é 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. 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`.

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 para o caso de sucesso)

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

Abra a porta 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 aberto do dispositivo para o 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 de fechamento. Comandos relativos de grande porte serão convertidos em um parâmetro de porcentagem exato (por exemplo, "Abrir um pouco mais as cortinas" em vez de "Abrir 5% das cortinas").
`openDirection`	String	Direção da abertura. Presente somente se o dispositivo for compatível com várias direções, conforme indicado pelo atributo `openDirection`, e se a direção for especificada pelo usuário. Os valores suportados são: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Número

Obrigatório.

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

openDirection

String

Direção da abertura. Presente somente se o dispositivo for compatível com várias direções, conforme indicado pelo atributo openDirection, e se a direção 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
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%

Dispositivo ERRORS

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

Esquema de traço do OpenClose da casa inteligente

ATRIBUTOS do dispositivo

Exemplos

STATES do dispositivo

Fechamento único de direção única

Fechamento aberto de várias direções

Exemplos

Dispositivo COMMANDS

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

Dispositivo ERRORS

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`