Esquema de rasgo de desbloqueo de Smart Home

action.devices.traits.LockUnlock: Esta característica pertenece a todos los dispositivos que admiten el bloqueo y el desbloqueo, o que informan un estado bloqueado.

ATRIBUTOS DISPOSITIVOS

Ninguno

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
isLocked	Booleano	Indica si el dispositivo está bloqueado en ese momento.
isJammed	Booleano	Si el dispositivo está bloqueado y, por lo tanto, no se puede determinar su estado bloqueado.

Ejemplos

Dispositivo bloqueado

{
  "isLocked": true
}

Dispositivo atascado

{
  "isJammed": true
}

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar 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. Es verdadero cuando el comando es 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"
  }
}

Destraba 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 este trait pueden devolver lo siguiente: carga útil de respuesta de seguimiento como parte de la operación EXECUTE. Para aprender sobre la implementación de respuestas de seguimiento, consulta Notificaciones para Acciones de casa inteligente

La carga útil contiene uno de los siguientes elementos:

Listo: bloqueado

Campos	Tipo	Descripción
followUpToken	String	Obligatorio. Token proporcionado en la solicitud EXECUTE original.
status	String	Obligatorio. Resultado de la solicitud. Valores admitidos: SUCCESS
isLocked	Booleano	Obligatorio. Indica si el dispositivo está bloqueado.

Con errores

Campos	Tipo	Descripción
followUpToken	String	Obligatorio. Token proporcionado en la solicitud EXECUTE original.
status	String	Obligatorio. Resultado de la solicitud. Valores admitidos: FAILURE
errorCode	String	Obligatorio. El valor puede ser cualquier código de error para esta característica, por ejemplo, deviceJammingDetected.

Ejemplos

Traba la puerta principal. (respuesta de seguimiento en caso de éxito)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": true,
      "followUpToken": "1234"
    }
  }
}

Destraba la puerta principal (respuesta de seguimiento en caso de éxito)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": false,
      "followUpToken": "1234"
    }
  }
}

Traba la puerta principal. (respuesta de seguimiento para casos 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

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.