Esquema de la función de OpenClose de la casa inteligente
action.devices.traits.OpenClose
: Esta característica pertenece a los dispositivos que admiten la apertura y el cierre, y, en algunos casos, la apertura y el cierre de forma parcial o potencialmente en más de una dirección.
ATRIBUTOS DEL Dispositivo
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 manejar los intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
discreteOnlyOpenClose |
Booleano |
(Predeterminado: Si se establece como verdadero, significa que el dispositivo debe estar abierto o cerrado por completo (es decir, no admite valores entre el 0% y el 100%). |
openDirection |
Matriz |
Lista de instrucciones admitidas en las que el dispositivo puede abrir o cerrar. 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 QUERY o al estado del informe para esta característica. |
queryOnlyOpenClose |
Booleano |
(Predeterminado: Indica si el dispositivo solo se puede consultar 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 de arriba 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 manejar los intents QUERY
, consulta Entrega de intents.
La carga útil contiene una de las siguientes opciones:
Dirección única de apertura y cierre
Estados | Tipo | Descripción |
---|---|---|
openPercent |
Número |
Obligatorio. Indica el porcentaje que un dispositivo tiene abierto, donde 0 está cerrado y 100 está completamente abierto. |
Apertura y cierre de varias direcciones
Estados | Tipo | Descripción |
---|---|---|
openState |
Matriz |
Obligatorio. Lista de estados para cada dirección abierta compatible. |
[item, ...] |
Objeto |
Estado actual de la dirección abierta determinada. |
openPercent |
Número |
Obligatorio. Indica el porcentaje que un dispositivo tiene abierto, donde 0 está cerrado y 100 está completamente abierto. |
openDirection |
String |
Obligatorio. Dirección en la que está abierto 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% hacia arriba.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
Dispositivo COMMAND
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 manejar 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 que un dispositivo tiene abierto, donde 0 está cerrado y 100 está completamente abierto. |
openDirection |
String |
Indica la dirección en la que se debe abrir. Solo está presente si el dispositivo admite varias direcciones, 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 con un 50% de descuento.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Errores relacionados
Se produjo un error al configurar 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 acerca de cómo implementar respuestas de seguimiento, consulta Notificaciones de Acciones de casa inteligente.
La carga útil contiene una de las siguientes opciones:
Listo
Campos | Tipo | Descripción |
---|---|---|
followUpToken |
String |
Obligatorio. El token proporcionado en la solicitud EXECUTE original. |
status |
String |
Obligatorio. Resultado de la solicitud. Valores admitidos:
|
openPercent |
Número |
Obligatorio. Indica el porcentaje de apertura de un dispositivo, donde 0 está cerrado y 100 está completamente abierto. |
Error
Campos | Tipo | Descripción |
---|---|---|
followUpToken |
String |
Obligatorio. El token proporcionado en la solicitud EXECUTE original. |
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 casos de éxito)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Abre la puerta de la cochera. (respuesta de seguimiento para el 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 amplios se convertirán en un parámetro de porcentaje exacto (por ejemplo, "Abre las persianas un poco más" frente a "Abre las persianas un 5%"). |
openDirection |
String |
Indica la dirección en la que se debe abrir. Solo está presente si el dispositivo admite varias direcciones, como lo indica el atributo Valores admitidos:
|
Ejemplos
Abre el dispositivo un poco más
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Cierra el dispositivo un 10% más
{ "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 configurar el estado de apertura y cierre del dispositivo.
Valores admitidos:
lockedState
deviceJammingDetected
Expresiones de muestra
de-DE
-
Bitte öffne
die Jalousien auf30% -
Fensterläden um25 % schliessen -
Ist
die Jalousie zu? -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Are
the blinds in the kitchen open -
Close
the blinds 25% inmy room -
Close
the door more -
Just close
the front door -
open
the blinds in my room -
open
the blinds to25% -
open
the door by25%
es-ES
-
abre
la ventana del salón -
cerrar
persianas del dormitorio un20% -
cierra
la cortina del salón -
cierra
mucho másla ventana -
está abierta
la puerta -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
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 de25% -
ouvre
les stores à25%
hi-IN
-
कृपया
25% पर्दे को खुला रखो -
क्या मैंने
सामने वाला दरवाजा खुला छोड दिया? -
पर्दे को25% बंद करोगे -
पर्दे खोलो -
ब्लाइंड 25% खुले पर सेट कर दीजिए -
ब्लाइंड कोथोड़ा और बंद कर दिजिए -
ब्लाइंड बंद करें
it-IT
-
abbassa
un po' di piùle tapparelle -
apri
la serranda -
apri
la tapparella al30% -
apri
le serrande del30% -
chiudi
le serrande -
chiudi
le tende del25% -
è 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 voor25% dicht -
doe
het raam ietsje meer dicht -
is
de voordeur open -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% 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 a50% -
abrir
as cortinas -
abrir
as cortinas na sala em30% -
fecha
a persiana por favor -
fecha
um bocado a janela -
fechar
as cortinas em25% -
fechar
um pouco maisas cortinas
sv-SE
-
Dra
upp persiennerna -
Dra
upp
persiennerna till25% -
stäng
persiennen i mitt rum 25% -
stäng
persiennerna -
är
ytterdörren öppen? -
öppna
persiennerna med25%