Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la característica de Smart Lock para el hogar

action.devices.traits.LockUnlock: Esta característica pertenece a cualquier dispositivo que admita el bloqueo y desbloqueo, o que informe un estado bloqueado.

ATTRIBUTES del dispositivo

Ninguno

Dispositivo STATEs

Los dispositivos con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre el manejo de 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 COMMANDS

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 el manejo de 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 es para bloquear y falso para desbloquear.

followUpToken String

Token proporcionado por Google para la respuesta de seguimiento.

Ejemplos

Bloquea 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"
  }
}

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 la implementación de respuestas de seguimiento, consulta Notificaciones para acciones de casa inteligente.

La carga útil contiene una de las siguientes opciones:

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 para el caso de éxito)

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

Desbloquea 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 del 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

  • traba mis puertas
  • desbloquear sala de estudio

es-ES

  • Cierra la puerta.
  • Quita el cerrojo de la puerta de entrada

fr-FR

  • déverrouille la porte d'entrée
  • verrouille la porte d'entrée

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.