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: 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:
|
commandOnlyOpenClose |
Booleano |
Padrão: 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: 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 |
---|---|---|
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:
|
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 |
---|---|---|
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 Os valores suportados são:
|
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" } }
Erros relacionados
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 |
---|---|---|
followUpToken |
String |
Obrigatório. Token fornecido na solicitação EXECUTE original. |
status |
String |
Obrigatório. Resultado da solicitação. Os valores suportados são:
|
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 |
---|---|---|
followUpToken |
String |
Obrigatório. Token fornecido na solicitação EXECUTE original. |
status |
String |
Obrigatório. Resultado da solicitação. Os valores suportados são:
|
errorCode |
String |
Obrigatório. O valor pode ser qualquer código de erro para essa característica, por exemplo, |
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
.
{ "commandOnlyOpenClose": false }
Parâmetros
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 Os valores suportados são:
|
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" } }
Erros relacionados
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%