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 do Trait OpenClose para casas inteligentes

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

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos	Tipo	Descrição
`discreteOnlyOpenClose`	Booleano	Padrão: `false`. Quando definido como verdadeiro, ele 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 este atributo se o dispositivo permitir 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 oferece suporte ao 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 ao estado do relatório dessa característica.
`queryOnlyOpenClose`	Booleano	Padrão: `false`. Indica se o dispositivo só pode ser consultado em busca de informações de estado e não pode ser controlado. Os sensores que só relatam o estado aberto precisam definir esse campo como "true".

Exemplos

Dispositivo simples com abertura/fechamento.

{
  "discreteOnlyOpenClose": true
}

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

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

Dispositivo somente comando.

{
  "commandOnlyOpenClose": false
}

STATES do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

O payload contém um dos seguintes itens:

Abertura/fechamento em direção única

Estados Tipo Descrição

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

openPercent

Número

Obrigatório.

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

Abertura/fechamento em várias direções

Estados	Tipo	Descrição
`openState`	Array	Obrigatório. Lista de estados para cada direção aberta compatível.
`[item, ...]`	Object	Estado atual para a direção aberta fornecida.
`openPercent`	Número	Obrigatório. Indica a porcentagem de um dispositivo aberto, em que 0 é fechado e 100 está totalmente aberto.
`openDirection`	String	Obrigatório. Direção em que o dispositivo é aberto. Os valores suportados são: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Exemplos

Dispositivo simples com abertura/fechamento.

{
  "openPercent": 100
}

Abra o dispositivo em 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 o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

`action.devices.commands.OpenClose`

Define o estado de abertura/fechamento do dispositivo.

Parâmetros

Parâmetros Tipo Descrição

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

openDirection

String

Direção em que abrir. Presente apenas se o dispositivo for compatível com várias direções, como indicado pelo atributo openDirection, e uma 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 50% para baixo.

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

Ocorreu um erro ao configurar o estado de abertura/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 a implementação de respostas de acompanhamento, consulte Notificações para ações de casa inteligente.

O payload contém um dos seguintes itens:

Concluído

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 de que um dispositivo está aberto, onde 0 está fechado e 100 está 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 de que um dispositivo está aberto, onde 0 está fechado e 100 está 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 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.

Os valores suportados são:

FAILURE

errorCode

String

Obrigatório.

O valor pode ser qualquer código de erro para essa 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 o caso de falha)

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

`action.devices.commands.OpenCloseRelative`

Ajusta o estado aberto/fechado 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 mudar o estado de abertura/fechamento. Os comandos relativos ambíguos serão convertidos em um parâmetro de porcentagem exato, por exemplo, "Abrir as cortinas um pouco mais" vs. "Abrir as cortinas em 5%".
`openDirection`	String	Direção em que abrir. Presente apenas se o dispositivo for compatível com várias direções, como indicado pelo atributo `openDirection`, e uma 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 mudar o estado de abertura/fechamento. Os comandos relativos ambíguos serão convertidos em um parâmetro de porcentagem exato, por exemplo, "Abrir as cortinas um pouco mais" vs. "Abrir as cortinas em 5%".

openDirection

String

Direção em que abrir. Presente apenas se o dispositivo for compatível com várias direções, como indicado pelo atributo openDirection, e uma 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 abertura/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%

ERROS DO Dispositivo

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

Esquema do Trait OpenClose para casas inteligentes

ATRIBUTOS do dispositivo

Exemplos

STATES do dispositivo

Abertura/fechamento em direção única

Abertura/fechamento em várias direções

Exemplos

Comandos do dispositivo

action.devices.commands.OpenClose

Parâmetros

Exemplos

Erros relacionados

Respostas de acompanhamento

Concluído

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 DO Dispositivo

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`