Esquema de la función Smart Lock de la casa inteligente
action.devices.traits.LockUnlock
: Esta característica pertenece a cualquier dispositivo que permita bloquear y desbloquear el dispositivo, o informar sobre un estado bloqueado.
ATRIBUTOS DEL Dispositivo
Ninguna
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.
Estados | Tipo | Descripción |
---|---|---|
isLocked |
Booleano |
Si el dispositivo está bloqueado |
isJammed |
Booleano |
Si el dispositivo está atascado y, por lo tanto, no se puede determinar su estado bloqueado. |
Ejemplos
Dispositivo bloqueado
{ "isLocked": true }
Dispositivo atascado
{ "isJammed": true }
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.LockUnlock
Bloquea o desbloquea el dispositivo.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
lock |
Booleano |
Obligatorio. Verdadero cuando el comando está para bloquear; falso para desbloquear. |
followUpToken |
String |
Token proporcionado por Google para la respuesta de seguimiento |
Ejemplos
Traba la puerta principal.
{ "command": "action.devices.commands.LockUnlock", "params": { "lock": true, "followUpToken": "123" } }
Desbloquea la puerta principal.
{ "command": "action.devices.commands.LockUnlock", "params": { "lock": false, "followUpToken": "567" } }
Errores relacionados
Se produjo un error al bloquear o desbloquear el dispositivo.
Valores admitidos:
remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked
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:
Éxito: bloqueado
Campos | Tipo | Descripción |
---|---|---|
followUpToken |
String |
Obligatorio. El token proporcionado en la solicitud EXECUTE original. |
status |
String |
Obligatorio. Resultado de la solicitud. Valores admitidos:
|
isLocked |
Booleano |
Obligatorio. Indica si el dispositivo está bloqueado. |
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
Traba la puerta principal. (respuesta de seguimiento para casos de éxito)
{ "LockUnlock": { "priority": 0, "followUpResponse": { "status": "SUCCESS", "isLocked": true, "followUpToken": "1234" } } }
Desbloquea la puerta principal. (respuesta de seguimiento para casos de éxito)
{ "LockUnlock": { "priority": 0, "followUpResponse": { "status": "SUCCESS", "isLocked": false, "followUpToken": "1234" } } }
Traba la puerta principal. (respuesta de seguimiento para el caso de falla)
{ "LockUnlock": { "priority": 0, "followUpResponse": { "status": "FAILURE", "errorCode": "deviceJammingDetected", "followUpToken": "1234" } } }
Expresiones de muestra
de-DE
-
Bitte
Eingangstür abschließen -
Bitte schließ
die Eingangstür auf
en-US
-
lock
my doors -
unlock
study room
es-ES
-
cierra
la puerta con llave -
quitar
el cerrojo de la puerta de entrad a
fr-FR
-
déverrouille
la porte d'entrée -
verrouille
la porte d'entrée
hi-IN
-
फ़्रंट डोर अनलॉक करो -
सामने के दरवाजे को लॉक करो
it-IT
-
apri
la porta d'ingresso -
puoi chiudere
la porta d'ingresso a chiave
ja-JP
-
玄関のドア を施錠して -
玄関 開錠して
ko-KR
-
도어락 잠가 줘 -
현관 도어락 열어 줄래
nl-NL
-
Ontgrendel
de voordeur -
doe
de voordeur op slot
pt-BR
-
Tranca
a porta do quarto . -
destranca
a porta da cozinha -
destrancar
a porta da frente -
trancar
a porta da frente
sv-SE
-
lås upp
ytterdörren -
lås
ytterdörren