Schema für die Smart-Home-Verzweigung der Arme
action.devices.traits.ArmDisarm
: Diese Eigenschaft unterstützt das Scharf- und Unscharfschalten, z. B. in Sicherheitssystemen.
Bei Geräten mit mehreren Sicherheitsebenen sollten diese mit dem Attribut availableArmLevels
gemeldet werden.
Gerät ATTRIBUTE
Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC
die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
availableArmLevels |
Objekt |
Beschreibt die unterstützten Sicherheitsstufen des Geräts. Wenn dieses Attribut nicht angegeben wird, unterstützt das Gerät nur eine Ebene. |
levels |
Array |
Erforderlich. Liste der verfügbaren Sicherheitsstufen, die vom Gerät unterstützt werden. |
[item, ...] |
Objekt |
Sicherheitsniveau. |
level_name |
String |
Erforderlich. Der interne Name der Sicherheitsebene, die in Befehlen und Status verwendet wird. Dieser Name kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet. |
level_values |
Array |
Erforderlich. Enthält |
[item, ...] |
Objekt |
Synonym für eine bestimmte Sprache. |
level_synonym |
Array |
Erforderlich. Nutzerfreundliche Namen für die Ebene in jeder unterstützten Sprache. Das erste Element wird als kanonischer Name behandelt. |
[item, ...] |
String |
Synonym name. |
lang |
String |
Erforderlich. Sprachcode für die Synonymebenen Siehe Unterstützte Sprachen. |
ordered |
Boolesch |
Erforderlich. Wenn die Richtlinie auf „true“ gesetzt ist, gilt eine zusätzliche Grammatik für die Logik zum Erhöhen/Verringern in der Reihenfolge des Arrays „levels“. Wenn Sie beispielsweise „Hey Google, erhöhe mein Sicherheitsniveau um 1“ sagen, ermittelt Assistant das aktuelle Sicherheitsniveau und erhöht dieses Sicherheitsniveau um eins. Wenn dieser Wert auf „false“ gesetzt ist, wird keine zusätzliche Grammatik für Logik zum Erhöhen oder Verringern nicht unterstützt. |
Beispiele
Sicherheitssystem mit zwei unterschiedlichen Armstufen
{ "availableArmLevels": { "levels": [ { "level_name": "L1", "level_values": [ { "level_synonym": [ "Home and Guarding", "SL1" ], "lang": "en" }, { "level_synonym": [ "zuhause und bewachen", "SL1" ], "lang": "de" } ] }, { "level_name": "L2", "level_values": [ { "level_synonym": [ "Away and Guarding", "SL2" ], "lang": "en" }, { "level_synonym": [ "weg und bewachen", "SL2" ], "lang": "de" } ] } ], "ordered": true } }
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 |
---|---|---|
isArmed |
Boolesch |
Erforderlich. Gibt an, ob das Gerät derzeit scharf geschaltet ist. |
currentArmLevel |
String |
Erforderlich. Erforderlich, wenn das Attribut |
exitAllowance |
Ganzzahl |
Gibt die Zeit in Sekunden an, die der Nutzer verlassen muss, bevor |
Beispiele
Sicherheitssystem, das verschiedene Armstufen meldet
{ "isArmed": true, "currentArmLevel": "L1" }
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.ArmDisarm
Stelle den Alarmpegel dieses Geräts ein.
Parameter
Die Nutzlast enthält einen der folgenden Werte:
Scharf- oder unscharf schalten
Parameter | Typ | Beschreibung |
---|---|---|
followUpToken |
String |
Von Google bereitgestelltes Token für die Folgeantwort. |
arm |
Boolesch |
Erforderlich. „True“, wenn der Befehl scharf geschaltet werden soll. Falsch, um unscharf zu schalten. |
cancel |
Boolesch |
Erforderlich. Wahr, wenn der Befehl den |
Aktivieren oder deaktivieren Sie das Gerät mit einem optionalen Sicherheitsniveau.
Parameter | Typ | Beschreibung |
---|---|---|
followUpToken |
String |
Von Google bereitgestelltes Token für die Folgeantwort. |
arm |
Boolesch |
Erforderlich. „True“, wenn der Befehl scharf geschaltet werden soll. Falsch, um unscharf zu schalten. |
armLevel |
String |
Das |
Beispiele
System aktivieren
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
System auf Stufe A scharf schalten
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Scharfschalten abbrechen
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
Ähnliche Fehler
Beim Scharf- oder Unscharfschalten des Geräts ist ein Fehler aufgetreten.
Unterstützte Werte:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled