Trait-Schema für Smart-Home-Sperre zum Entsperren

action.devices.traits.LockUnlock: Dieser Trait gehört zu allen Geräten, die das Ver- und Entriegeln unterstützen und/oder einen Sperrstatus melden.

Geräte-ATTRIBUTES

Keine.

Gerät: STATES

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Bundesstaaten Typ Beschreibung
isLocked Boolesch

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

isJammed Boolesch

Gibt an, ob das Gerät momentan blockiert ist und daher sein Sperrstatus nicht ermittelt werden kann.

Beispiele

Gerät, das gesperrt ist

{
  "isLocked": true
}

Gerät, das klemmt

{
  "isJammed": true
}

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.LockUnlock

Sperren oder entsperren Sie das Gerät.

Parameter

Parameter Typ Beschreibung
lock Boolesch

Erforderlich.

„True“, wenn es mit dem Befehl gesperrt werden soll, „false“ zum Entsperren.

followUpToken String

Von Google bereitgestelltes Token für die weiterführende Antwort.

Beispiele

Schließ die Haustür ab.

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

Schließ die Haustür auf.

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

Anschlussantworten

Geräte mit diesem Merkmal können Folgendes zurückgeben: Nutzlast der Folgeantwort als Teil des Vorgangs EXECUTE. Weitere Informationen Weitere Informationen zur Implementierung von Folgeantworten finden Sie unter Benachrichtigungen für Smart-Home-Aktionen

Die Nutzlast enthält eines der folgenden Elemente:

Erfolg: Gesperrt

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Token in der ursprünglichen EXECUTE-Anfrage.

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 in der ursprünglichen EXECUTE-Anfrage.

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ß die Haustür ab. (Folgeantwort für eine erfolgreiche Anfrage)

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

Schließ die Haustür auf. (Folgeantwort für eine erfolgreiche Anfrage)

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

Schließ die Haustür ab. (Folgeantwort auf Fehler bei Fall)

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

Beispieläußerungen

<ph type="x-smartling-placeholder">

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

Vollständige Liste der Fehler und Ausnahmen.