Esquema de atributo de desbloqueio/bloqueio da casa inteligente

action.devices.traits.LockUnlock: essa característica pertence a todos os dispositivos com suporte a bloqueio e desbloqueio e/ou que informam um estado bloqueado.

ATRIBUTOS do dispositivo

Nenhum.

ESTADOS DO DISPOSITIVO

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Estados Tipo Descrição
isLocked Booleano

Se o dispositivo está bloqueado.
isJammed Booleano

Se o dispositivo está emperrado e, portanto, não é possível determinar o estado de bloqueio.

Exemplos

Dispositivo bloqueado

{
  "isLocked": true
}

Dispositivo travado

{
  "isJammed": true
}

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

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 a resposta de acompanhamento.

Exemplos

Trancar a porta da frente.

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

Trancar a porta da frente.

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

Ocorreu um erro ao bloquear ou desbloquear o dispositivo.

Valores aceitos:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

Respostas de acompanhamento

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

O payload contém um dos seguintes:

Sucesso: bloqueado

Campos Tipo Descrição
followUpToken String

Obrigatório.

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

Obrigatório.

Resultado da solicitação.

Valores aceitos:

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 EXECUTAR original.
status String

Obrigatório.

Resultado da solicitação.

Valores aceitos:

FAILURE
errorCode String

Obrigatório.

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

Exemplos

Trancar a porta da frente. (follow-up response for success case)

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

Destrancar a porta da frente. (follow-up response for success case)

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

Trancar a porta da frente. (resposta de acompanhamento para o 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

ERROS do dispositivo

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