Schema für Trait-Entsperrung per Smart-Home-Sperre

action.devices.traits.LockUnlock: Diese Trait gehört zu allen Geräten, die das Sperren und Entsperren unterstützen und/oder einen Sperrstatus melden.

Geräte-ATTRIBUTE

Keine.

Gerät STATES

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

Bundesstaaten Typ Beschreibung
isLocked Boolesch

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

isJammed Boolesch

Es kann nicht festgestellt werden, ob das Gerät derzeit klemmt und somit gesperrt ist.

Beispiele

Gerät, das gesperrt ist

{
  "isLocked": true
}

Gerät klemmt

{
  "isJammed": true
}

BEFEHLUNGEN auf dem Gerät

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

action.devices.commands.LockUnlock

Sperren oder entsperren Sie das Gerät.

Parameter

Parameter Typ Beschreibung
lock Boolesch

Erforderlich.

„True“, wenn der Befehl zum Sperren lautet, „false“ zum Entsperren.

followUpToken String

Von Google bereitgestelltes Token für die Folgeantwort.

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

Folgeantworten

Geräte mit dieser Eigenschaft können als Teil des EXECUTE-Vorgangs die folgende Nutzlast der Folgeantwort zurückgeben. Weitere Informationen zum Implementieren von Folgeantworten findest du unter Benachrichtigungen für Smart-Home-Aktionen.

Die Nutzlast enthält eines der folgenden Elemente:

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 diese Eigenschaft sein, z. B. deviceJammingDetected.

Beispiele

Schließ die Haustür ab. (Folgeantwort bei Erfolgsfall)

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

Schließ die Haustür auf. (Folgeantwort bei Erfolgsfall)

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

Schließ 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ät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.