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 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 die folgenden Attribute als Teil des Vorgangs SYNC 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
  }
}

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