Smart Home LockUnlock Trait Schema

action.devices.traits.LockUnlock: Dieses Attribut gehört zu allen Geräten, die das Ver- und Entriegeln und/oder das Melden eines verriegelten Zustands unterstützen.

Geräteattribute

Keine.

Gerätestatus

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

Beispiele

Gesperrtes Gerät

{
  "isLocked": true
}

Gerät, das gestört wird

{
  "isJammed": true
}

GERÄTEBEFEHLE

Geräte mit diesem Merkmal reagieren möglicherweise auf die folgenden Befehle im Rahmen des Vorgangs EXECUTE. Weitere Informationen zur Verarbeitung von EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.LockUnlock

Gerät sperren oder entsperren

Parameter

Beispiele

Schließ die Haustür ab.

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

Entriegle die Haustür.

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

Ähnliche Fehler

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

Unterstützte Werte:

remoteSetDisabled

deviceJammingDetected

notSupported

alreadyLocked

alreadyUnlocked

Folgeantworten

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

Die Nutzlast enthält eines der folgenden Elemente:

Erfolg: Gesperrt

Fehler

Beispiele

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

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

Entriegle die Haustür. (Folgeantwort für Erfolgsfall)

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

Schließe die Haustür ab. (Folgeantwort für den Fehlerfall)

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

Beispieläußerungen

GERÄTEFEHLER