Esquema de trait OpenClose de casa inteligente
action.devices.traits.OpenClose
: Esta característica pertenece a dispositivos que admiten la apertura y el cierre y, en algunos casos, de forma parcial o posiblemente en más de una dirección.
Dispositivo ATTRIBUTES
Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo controlar los intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
discreteOnlyOpenClose |
Booleano |
(Predeterminado: Cuando se establece como verdadera, indica que el dispositivo debe estar completamente abierto o cerrado (es decir, no admite valores entre 0% y 100%). |
openDirection |
Matriz |
Lista de instrucciones admitidas sobre cómo llegar en las que se puede abrir o cerrar el dispositivo. Incluye este atributo si el dispositivo admite la apertura y el cierre en más de una dirección. |
[item, ...] |
String |
Dirección admitida. Valores admitidos:
|
commandOnlyOpenClose |
Booleano |
(Predeterminado: Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent de QUERY o a un estado de informe de esta característica. |
queryOnlyOpenClose |
Booleano |
(Predeterminado: Indica si el dispositivo solo puede consultarse para obtener información de estado y no se puede controlar. Los sensores que solo pueden informar el estado abierto deben establecer este campo en verdadero. |
Ejemplos
Dispositivo simple de apertura y cierre.
{ "discreteOnlyOpenClose": true }
Dispositivo con arriba y abajo. Se puede abrir en cualquier dirección.
{ "openDirection": [ "UP", "DOWN" ] }
Dispositivo solo de comando.
{ "commandOnlyOpenClose": false }
Dispositivo STATES
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre cómo controlar los intents QUERY
, consulta Entrega de intents.
La carga útil contiene uno de los siguientes elementos:
Dirección única de apertura y cierre
Estados | Tipo | Descripción |
---|---|---|
openPercent |
Número |
Obligatorio. Indica el porcentaje de apertura de un dispositivo, es decir, 0 cuando se cierra y 100 cuando está completamente abierto. |
Apertura y cierre en varias direcciones
Estados | Tipo | Descripción |
---|---|---|
openState |
Matriz |
Obligatorio. Lista de estados para cada dirección de apertura admitida. |
[item, ...] |
Objeto |
El estado actual de la dirección de apertura especificada. |
openPercent |
Número |
Obligatorio. Indica el porcentaje de apertura de un dispositivo, es decir, 0 cuando se cierra y 100 cuando está completamente abierto. |
openDirection |
String |
Obligatorio. Dirección en la que se abre el dispositivo. Valores admitidos:
|
Ejemplos
Dispositivo simple de apertura y cierre.
{ "openPercent": 100 }
Abre el dispositivo un 30% en dirección hacia abajo y un 50% en dirección hacia arriba.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
COMANDOS del dispositivo
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo controlar los intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.OpenClose
Establece el estado de apertura y cierre del dispositivo.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
openPercent |
Número |
Obligatorio. Indica el porcentaje de apertura de un dispositivo, es decir, 0 cuando se cierra y 100 cuando está completamente abierto. |
openDirection |
String |
Dirección de apertura. Solo está presente si el dispositivo admite varias instrucciones sobre cómo llegar, como lo indica el atributo Valores admitidos:
|
followUpToken |
String |
Token proporcionado por Google para la respuesta de seguimiento. |
Ejemplos
Abre el dispositivo.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
Abre el dispositivo un 50% hacia abajo.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Errores relacionados
Se produjo un error al establecer el estado de apertura y cierre del dispositivo.
Valores admitidos:
lockedState
deviceJammingDetected
Respuestas de seguimiento
Los dispositivos con esta característica pueden mostrar la siguiente carga útil de respuesta de seguimiento como parte de la operación EXECUTE
. Para obtener más información sobre la implementación de respuestas de seguimiento, consulta Notificaciones para acciones de casa inteligente.
La carga útil contiene uno de los siguientes elementos:
Completado correctamente
Campos | Tipo | Descripción |
---|---|---|
followUpToken |
String |
Obligatorio. El token proporcionado en la solicitud original EXECUTE. |
status |
String |
Obligatorio. Resultado de la solicitud. Valores admitidos:
|
openPercent |
Número |
Obligatorio. Indica el porcentaje de apertura de un dispositivo, donde 0 se cierra y 100 está completamente abierto. |
Con errores
Campos | Tipo | Descripción |
---|---|---|
followUpToken |
String |
Obligatorio. El token proporcionado en la solicitud original EXECUTE. |
status |
String |
Obligatorio. Resultado de la solicitud. Valores admitidos:
|
errorCode |
String |
Obligatorio. El valor puede ser cualquier código de error para esta característica, por ejemplo, |
Ejemplos
Abre la puerta de la cochera. (respuesta de seguimiento para el caso de éxito)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Abre la puerta de la cochera. (respuesta de seguimiento para un caso de falla)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Ajusta el estado de apertura y cierre del dispositivo en relación con el estado actual. Este comando solo está disponible si commandOnlyOpenClose
se configura como false
.
{ "commandOnlyOpenClose": false }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
openRelativePercent |
Número |
Obligatorio. El porcentaje exacto para cambiar el estado de apertura y cierre. Los comandos relativos ambiciosos se convertirán en un parámetro de porcentaje exacto (por ejemplo, "Abrir un poco más las persianas" en comparación con "Abrir las persianas un 5%"). |
openDirection |
String |
Dirección de apertura. Solo está presente si el dispositivo admite varias instrucciones sobre cómo llegar, como lo indica el atributo Valores admitidos:
|
Ejemplos
Abre un poco más el dispositivo
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Cerrar un 10% más el dispositivo
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Abre el dispositivo un 50% más hacia abajo.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Errores relacionados
Se produjo un error al establecer el estado de apertura y cierre del dispositivo.
Valores admitidos:
lockedState
deviceJammingDetected
Expresiones de muestra
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%