Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Schema für Smart Lock für die Smart Lock-Entsperrung

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

Gerät ATTRIBUTE

Keine.

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände 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 momentan gesperrt ist.

isJammed Boolesch

Gibt an, ob das Gerät momentan klemmt und daher nicht gesperrt werden kann.

Beispiele

Gerät ist gesperrt

{
  "isLocked": true
}

Gerät, das klemmt

{
  "isJammed": true
}

Gerätebefehle

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

action.devices.commands.LockUnlock

Gerät sperren oder entsperren

Parameter

Parameter Typ Beschreibung
lock Boolesch

Erforderlich.

„True“, wenn der Befehl gesperrt werden soll, „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 ab.

{
  "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 diesem Attribut können die folgende Antwortantwortantwort als Teil des Vorgangs EXECUTE zurückgeben. Weitere Informationen zum Implementieren von Folgeantworten finden Sie unter Benachrichtigungen für Smart-Home-Aktionen.

Die Nutzlast enthält einen der folgenden Werte:

Erfolg: Gesperrt

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Token, das in der ursprünglichen EXECUTE-Anfrage bereitgestellt 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 bereitgestellt 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 für Erfolg)

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

Schließ die Haustür ab. (Folgeantwort für Erfolg)

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

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

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

Vollständige Liste der Fehler und Ausnahmen