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" } }
Ä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 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:
|
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:
|
errorCode |
String |
Erforderlich. Der Wert kann ein beliebiger Fehlercode für diese Eigenschaft sein, z. B. |
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