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.

Smart-Home-Schalter für die Ausführung wechseln

action.devices.traits.Toggles: Diese Eigenschaft gehört zu allen Geräten mit Einstellungen, die nur in einem von zwei Zuständen vorhanden sein können.

Diese Einstellungen können eine physische Schaltfläche mit einem aktivierten/deaktivierten bzw. aktiven/inaktiven Zustand, ein Kästchen in HTML oder eine andere Art von speziell aktiviertem/deaktiviertem Element sein. Wenn die Einstellung mehr als zwei Zustände hat oder einen Zustand hat, in dem keine der binären Optionen ausgewählt ist, wird sie besser als Eigenschaft Modi dargestellt, die der Mehrfachauswahl von Wahlmenüs, Optionsfeldern (physisch oder HTML) oder binären Zuständen, die nicht explizit aktiviert/deaktiviert sind (z. B. "AM/FM" oder "Hot/Kalt") entspricht.

Diese Eigenschaft deckt einen oder mehrere einzelne Schalter ab, die Nutzer festlegen können. Diese Ein-/Aus-Schaltflächen sollten im Allgemeinen für Funktionen verwendet werden, bei denen die Verknüpfung mit anderem Geräteverhalten nicht aufgehoben wurde. Verknüpftes Verhalten, z. B. das Ein- oder Ausschalten des Geräts, sollte spezifischere Merkmale verwenden, z. B. thermostatMode im Attribut TemperatureSetting.

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
availableToggles Array

Erforderlich.

Liste der verfügbaren Ein-/Aus-Schaltflächen.

[item, ...] Objekt

Ein-/Aus-Schaltfläche verfügbar.

name String

Erforderlich.

Interner Name des Schalters, der in Befehlen und Status verwendet wird. Diese Funktion kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.

name_values Array

Erforderlich.

Synonyme für den Schalter in jeder unterstützten Sprache.

[item, ...] Objekt

Synonyme für den Schalter in einer bestimmten Sprache.

name_synonym Array

Erforderlich.

Synonyme für die Ein-/Aus-Schaltfläche. Der erste String in dieser Liste wird als kanonischer Name der Ebene in dieser Sprache verwendet.

[item, ...] String

Synonym name.

lang String

Erforderlich.

Sprachcode (ISO 639-1) Siehe unterstützte Sprachen.

commandOnlyToggles Boolesch

(Standard: false)

Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann.

queryOnlyToggles Boolesch

(Standard: false)

Erforderlich, wenn das Gerät die Ausführung nur für Abfragen unterstützt. Dieses Attribut gibt an, ob das Gerät nur für Statusinformationen abgefragt werden kann und nicht gesteuert werden kann.

Beispiele

Gerät mit Mehrfachschalter.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "clean",
            "bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "energy saving",
            "eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Gerät mit Ein-/Aus-Schaltflächen

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Gerät mit Ein-/Aus-Schaltflächen für Abfragen

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": 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
currentToggleSettings Objekt

Erforderlich.

Schlüssel/Wert-Paar mit dem Schalter name des Geräts als Schlüssel und dem aktuellen Status als Wert.

<string> Boolesch

Aktueller Ein-/Aus-Status.

Beispiele

Ist die Sterilisierung aktiviert?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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.SetToggles

Legen Sie einen bestimmten Umschaltzustand fest.

Parameter

Parameter Typ Beschreibung
updateToggleSettings Objekt

Erforderlich.

Schlüssel/Wert-Paar mit dem Schalter name des Geräts als Schlüssel und dem neuen Status als Wert.

<string> Boolesch

Neuer Ein-/Aus-Status

Beispiele

Schalte den Energiesparmodus ein.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Filter deaktivieren.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Beispieläußerungen

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • activate power freeze for the freezer
  • cancel power cool for the kitchen fridge

es-ES

  • pon el enfriamiento rápido en la nevera
  • quita el enfriamiento rápido

fr-FR

  • mets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

hi-IN

  • रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
  • रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

  • disattiva il power freeze del freezer
  • imposta la funzione power freeze del surgelatore

ja-JP

  • 冷蔵庫 急速冷凍 つけて
  • 冷蔵庫 急速冷凍 を切ってくれる

ko-KR

  • 냉장고 급속 냉장 해제해
  • 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

  • Zet de power cool uit op de koelkast
  • zet de koelkast op superkoelen

pt-BR

  • Ativa a função power freeze no congelador .
  • Desativa o bloqueio infantil do forno .
  • desligar o power cool da geladeira
  • iniciar o modo power freeze do freezer

sv-SE

  • Stäng av power cool i kylskåpet
  • sätt på power freeze frysen

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen