Esquema de traço da Smart Lock LockUnlock

action.devices.traits.LockUnlock: esta característica pertence a qualquer dispositivo compatível com bloqueio e desbloqueio e/ou denúncia de estado bloqueado.

ATRIBUTOS do dispositivo

Nenhuma.

STATES do dispositivo

As entidades com essa característica podem informar os estados a seguir como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte fulfillment de intent.

Estados Tipo Descrição
isLocked Booleano

Se o dispositivo está bloqueado no momento.
isJammed Booleano

Se o dispositivo está bloqueado e, portanto, o estado bloqueado não pode ser determinado.

Exemplos

Dispositivo bloqueado

{
  "isLocked": true
}

O dispositivo está bloqueado

{
  "isJammed": true
}

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.LockUnlock

Bloqueie ou desbloqueie o dispositivo.

Parâmetros

Parâmetros Tipo Descrição
lock Booleano

Obrigatório.

Verdadeiro quando o comando é para bloquear, falso para desbloquear.
followUpToken String

Token fornecido pelo Google para resposta de acompanhamento.

Exemplos

Tranque a porta da frente.

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

Destranque a porta da frente.

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

Ocorreu um erro ao bloquear ou desbloquear o dispositivo.

Os valores suportados são:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

Respostas de acompanhamento

Dispositivos com essa característica podem retornar o payload de resposta de acompanhamento a seguir como parte da operação EXECUTE. Para saber mais sobre como implementar respostas de acompanhamento, consulte Notificações para ações de casa inteligente.

O payload contém um dos seguintes itens:

Sucesso: bloqueado

Campos Tipo Descrição
followUpToken String

Obrigatório.

Token fornecido na solicitação EXECUTE original.
status String

Obrigatório.

Resultado da solicitação.

Os valores suportados são:

SUCCESS
isLocked Booleano

Obrigatório.

Indica se o dispositivo está bloqueado.

Falha

Campos Tipo Descrição
followUpToken String

Obrigatório.

Token fornecido na solicitação EXECUTE original.
status String

Obrigatório.

Resultado da solicitação.

Os valores suportados são:

FAILURE
errorCode String

Obrigatório.

O valor pode ser qualquer código de erro dessa característica, por exemplo, deviceJammingDetected.

Exemplos

Tranque a porta da frente. (resposta de acompanhamento para o caso de sucesso)

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

Destranque a porta da frente. (resposta de acompanhamento para o caso de sucesso)

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

Tranque a porta da frente. (resposta de acompanhamento para caso de falha)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "deviceJammingDetected",
      "followUpToken": "1234"
    }
  }
}

Exemplos de declarações

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

Dispositivo ERRORS

Veja a lista completa de erros e exceções.