Esquema de características OpenClose da casa inteligente

action.devices.traits.OpenClose : essa característica pertence a dispositivos que podem ser abertos e fechados e, em alguns casos, abertos e fechados parcialmente 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 SYNC operação. Para saber mais sobre como processar SYNC intents, consulte Processamento de intents.

Atributos Tipo Descrição
discreteOnlyOpenClose Booleano

Padrão: false.

Quando definido como verdadeiro, indica que o dispositivo precisa estar totalmente aberto ou totalmente fechado. Ou seja, ele não aceita valores entre 0% e 100%.
openDirection Array

Lista de direções aceitas em que o dispositivo pode ser aberto ou fechado. Inclua esse atributo se o dispositivo puder ser aberto e fechado em mais de uma direção.
[item, ...] String

Direção aceita.

Valores aceitos:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Booleano

Padrão: false.

Indica se o dispositivo aceita 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 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 verdadeiro.

Exemplos

Dispositivo simples de abrir e fechar.

{
  "discreteOnlyOpenClose": true
}

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

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

Dispositivo somente de comando.

{
  "commandOnlyOpenClose": false
}

Estados do dispositivo

As entidades com essa característica podem informar os seguintes estados como parte da QUERY operação. Para saber mais sobre como processar QUERY intents, consulte Processamento de intents.

O payload contém um dos seguintes:

Abrir e fechar em uma única direção

Estados Tipo Descrição
openPercent Número

Obrigatório.

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

O valor precisa estar entre 0 e 100.
targetOpenPercent Número

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

O valor precisa estar entre 0 e 100.

Abrir e fechar em várias direções

Estados Tipo Descrição
openState Array

Obrigatório.

Lista de estados para cada direção de abertura aceita.
[item, ...] Object

Estado atual para a direção de abertura especificada.
openPercent Número

Obrigatório.

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

O valor precisa estar entre 0 e 100.
targetOpenPercent Número

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

O valor precisa estar entre 0 e 100.
openDirection String

Obrigatório.

Direção em que o dispositivo é aberto.

Valores aceitos:

UP
DOWN
LEFT
RIGHT
IN
OUT

Exemplos

Dispositivo simples de abrir e fechar.

{
  "openPercent": 100
}

Dispositivo simples de abrir e fechar que está sendo aberto para uma nova posição.

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

Dispositivo aberto em 30% na direção para baixo e em 50% na direção para cima.

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

Dispositivo aberto em 30% na direção para baixo e em 50% na direção para cima, atualmente se movendo para 80% na direção para cima.

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

Comandos do dispositivo

Os dispositivos com essa característica podem responder aos seguintes comandos como parte da EXECUTE operação. Para saber mais sobre como processar EXECUTE intents, consulte Processamento de intents.

action.devices.commands.OpenClose

Defina o estado de abertura e fechamento do dispositivo.

Parâmetros

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

Obrigatório.

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

O valor precisa estar entre 0 e 100.
openDirection String

Direção em que abrir. Só está presente se o dispositivo aceitar várias direções, conforme indicado pelo atributo openDirection, e uma direção for especificada pelo usuário.

Valores aceitos:

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 definir o estado de abertura e fechamento do dispositivo.

Valores aceitos:

lockedState
deviceJammingDetected

Respostas de acompanhamento

Os 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 para Ações de casa inteligente.

O payload contém um dos seguintes:

Sucesso

Campos Tipo Descrição
followUpToken String

Obrigatório.

Token fornecido na solicitação EXECUTE original.
status String

Obrigatório.

Resultado da solicitação.

Valores aceitos:

SUCCESS
openPercent Número

Obrigatório.

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

O valor precisa estar entre 0 e 100.

Falha

Campos Tipo Descrição
followUpToken String

Obrigatório.

Token fornecido na solicitação EXECUTE original.
status String

Obrigatório.

Resultado da solicitação.

Valores aceitos:

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 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 de abertura e fechamento do dispositivo em relação ao estado atual. Esse comando só está disponível se discreteOnlyOpenClose estiver definido como false.

Esse comando exige os seguintes atributos: 
{
  "discreteOnlyOpenClose": false
}

Parâmetros

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

Obrigatório.

A porcentagem exata para mudar o estado de abertura e fechamento. Comandos relativos ambíguos serão convertidos em um parâmetro de porcentagem exata (por exemplo, "Abra um pouco mais as persianas" em vez de "Abra as persianas em 5%").

O valor precisa estar entre -100 e 100.
openDirection String

Direção em que abrir. Só está presente se o dispositivo aceitar várias direções, conforme indicado pelo atributo openDirection, e uma direção for especificada pelo usuário.

Valores aceitos:

UP
DOWN
LEFT
RIGHT
IN
OUT

Exemplos

Abra um pouco mais o dispositivo

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

Feche o dispositivo em mais 10%

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

Abra o dispositivo em mais 50%, para baixo.

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

Ocorreu um erro ao definir o estado de abertura e fechamento do dispositivo.

Valores aceitos:

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

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