Smart-Home-Schloss-/Entrieglungsmerkmalschema

action.devices.traits.LockUnlock: Diese Eigenschaft gehört zu allen Geräten, die das Sperren und Entsperren unterstützen und/oder den gesperrten Status melden.

Geräteattribute

Keine.

GERÄTESTATUS

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
isLocked Boolesch

Gibt an, ob das Gerät derzeit gesperrt ist.
isJammed Boolesch

Gibt an, ob das Gerät derzeit klemmt und der Verriegelungsstatus daher nicht ermittelt werden kann.

Beispiele

Gesperrtes Gerät

{
  "isLocked": true
}

Gerät ist verklemmt

{
  "isJammed": true
}

Gerätebefehle

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.LockUnlock

Sperren oder entsperren Sie das Gerät.

Parameter

Parameter Typ Beschreibung
lock Boolesch

Erforderlich.

„Wahr“, wenn der Befehl zum Sperren ist, „Falsch“, wenn er zum Entsperren ist.
followUpToken String

Von Google bereitgestelltes Token für die Antwort auf ein Folgeersuchen.

Beispiele

Schließen Sie die Haustür ab.

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

Entriegeln Sie die Haustür.

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

Beim Sperren oder Entsperren des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

Folgeantworten

Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE-Vorgangs die folgende Nutzlast für die Folgeantwort zurückgeben. Weitere Informationen zur Implementierung von Folgeantworten finden Sie unter Benachrichtigungen für Smart-Home-Aktionen.

Die Nutzlast enthält Folgendes:

Erfolg: Gesperrt

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Token, das in der ursprünglichen EXECUTE-Anfrage angegeben wurde.
status String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

SUCCESS
isLocked Boolesch

Erforderlich.

Gibt an, ob das Gerät gesperrt ist.

Fehler

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Token, das in der ursprünglichen EXECUTE-Anfrage angegeben wurde.
status String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

FAILURE
errorCode String

Erforderlich.

Der Wert kann ein beliebiger Fehlercode für dieses Merkmal sein, z. B. deviceJammingDetected.

Beispiele

Schließen Sie die Haustür ab. (Folgeantwort für Erfolgsfall)

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

Schließen Sie die Haustür auf. (Folgeantwort für Erfolgsfall)

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

Schließen Sie die Haustür ab. (Folgeantwort bei Fehlerfall)

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

Beispieläußerungen

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

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen