Esquema de atributos de bloqueo y desbloqueo de la casa inteligente

action.devices.traits.LockUnlock: Este atributo pertenece a cualquier dispositivo que admita el bloqueo y desbloqueo, o que informe un estado bloqueado.

ATRIBUTOS del dispositivo

Ninguno

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Estados Tipo Descripción
isLocked Booleano

Indica si el dispositivo está bloqueado en este momento.
isJammed Booleano

Si el dispositivo está atascado y, por lo tanto, no se puede determinar su estado de bloqueo.

Ejemplos

Dispositivo bloqueado

{
  "isLocked": true
}

Dispositivo atascado

{
  "isJammed": true
}

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 intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.LockUnlock

Bloquear o desbloquear el dispositivo

Parámetros

Parámetros Tipo Descripción
lock Booleano

Obligatorio.

Es verdadero cuando el comando es de bloqueo y falso cuando es de desbloqueo.
followUpToken String

Es el token que proporciona Google para la respuesta de seguimiento.

Ejemplos

Traba la puerta principal.

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": true,
    "followUpToken": "123"
  }
}

Destrabar la puerta principal

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": false,
    "followUpToken": "567"
  }
}

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 sobre cómo implementar respuestas de seguimiento, consulta Notificaciones para Acciones de casa inteligente.

La carga útil contiene una de las siguientes opciones:

Éxito: Bloqueado

Campos Tipo Descripción
followUpToken String

Obligatorio.

Token proporcionado en la solicitud EXECUTE original.
status String

Obligatorio.

Es el resultado de la solicitud.

Valores admitidos:

SUCCESS
isLocked Booleano

Obligatorio.

Indica si el dispositivo está bloqueado.

Se produjo un error al subir el archivo

Campos Tipo Descripción
followUpToken String

Obligatorio.

Token proporcionado en la solicitud EXECUTE original.
status String

Obligatorio.

Es el resultado de la solicitud.

Valores admitidos:

FAILURE
errorCode String

Obligatorio.

El valor puede ser cualquier código de error para este atributo, por ejemplo, deviceJammingDetected.

Ejemplos

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

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

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

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

Traba la puerta principal. (respuesta de seguimiento para el caso de error)

{
  "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 del dispositivo

Consulta la lista completa de errores y excepciones.