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 level_synonym und lang.
[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 availableArmLevels angegeben ist. Gibt es mehrere Sicherheitsstufen. Gibt den Namen der aktuellen Sicherheitsstufe an.
exitAllowance	Ganzzahl	Gibt die Zeit in Sekunden an, die der Nutzer verlassen muss, bevor currentArmLevel wirksam wird.

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 arm-Wert abbrechen soll.

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 level_name, das scharf geschaltet werden soll.

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

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen