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 FanSpeed Trait – Smart Home

action.devices.traits.FanSpeed: Diese Eigenschaft gehört zu Geräten, die die Einstellung der Lüftergeschwindigkeit unterstützen.

Lüftergeschwindigkeiten (d. h. Luft aus dem Gerät auf verschiedenen Ebenen, die Teil einer Klimaanlage, Heizung oder eines Autos sein können) können Einstellungen wie „Niedrig“, „Mittel“ und „Hoch“ oder einen Prozentsatz enthalten.

ATTRIBUTE DES Geräts

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
reversible Boolesch

(Standard: false)

Wenn die Richtlinie auf „true“ gesetzt wird, unterstützt dieses Gerät den Lüfter in beide Richtungen und kann den Befehl zum Umkehren der Lüftung entgegennehmen.

commandOnlyFanSpeed Boolesch

(Standard: false)

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

Enthält mindestens eines der folgenden Elemente:
0 Objekt

Unterstützung für Geschwindigkeitseinstellungen.

availableFanSpeeds Objekt

Erforderlich.

Vom Gerät unterstützte Geschwindigkeitseinstellungen.

speeds Array

Erforderlich.

Liste der Geschwindigkeitseinstellungen.

[item, ...] Objekt

Geschwindigkeit einstellen.

speed_name String

Erforderlich.

Interner Name der Geschwindigkeitseinstellung. Diese Datei ist nicht nutzerfreundlich und wird in allen Sprachen verwendet.

speed_values Array

Erforderlich.

Synonyme für die Geschwindigkeitseinstellung in den unterstützten Sprachen.

[item, ...] Objekt

Synonym für die Geschwindigkeitseinstellung in einer bestimmten Sprache.

speed_synonym Array

Erforderlich.

Synonyme für die Geschwindigkeitseinstellung sollten, sofern vorhanden, sowohl Singular- als auch Pluralformen enthalten. Das erste Synonym in der Liste gilt als kanonischer Name der Geschwindigkeitseinstellung.

[item, ...] String

Synonym.

lang String

Erforderlich.

Sprachcode (ISO 639-1). Weitere Informationen

ordered Boolesch

Erforderlich.

Wenn die Richtlinie auf „true“ gesetzt ist, wird eine zusätzliche Grammatik zum Erhöhen oder Verringern der Logik in der Reihenfolge (Anstieg) des Speeds-Arrays angewendet.

1 Objekt

Unterstützung für Geschwindigkeit in Prozent.

supportsFanSpeedPercent Boolesch

Erforderlich.

(Standard: false)

Wenn der Wert auf „true“ gesetzt ist, akzeptiert das Gerät Befehle zum Anpassen der Geschwindigkeit mit einem Prozentsatz von 0,0 bis 100,0.

Beispiele

Gerät mit zwei Einstellungen für die Geschwindigkeit, Unterstützung für umgekehrte Richtung und prozentuale Anpassungen.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "low",
              "slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "high",
              "fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
currentFanSpeedSetting String

Das ist der interne Name der aktuellen Geschwindigkeitseinstellung aus dem Attribut availableFanSpeeds.

currentFanSpeedPercent Number

Gibt die aktuelle Lüftergeschwindigkeit in Prozent an. Erforderlich, wenn das supportsFanSpeedPercent-Attribut auf „true“ festgelegt ist

Beispiele

Wie schnell sind die Ventilatoren im Wohnzimmer?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

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

Geschwindigkeit festlegen.

Parameter

Die Nutzlast enthält einen der folgenden Werte:

Du kannst die Geschwindigkeit in den Einstellungen festlegen.

Parameter Typ Beschreibung
fanSpeed String

Erforderlich.

Die erforderlichen Geschwindigkeitseinstellungen des Lüfters.

Lege die Geschwindigkeit in Prozent fest.

Parameter Typ Beschreibung
fanSpeedPercent Number

Erforderlich.

Die angeforderte Geschwindigkeit in Prozent.

Beispiele

Stell den Lüfter auf eine hohe Stufe.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Stell den Lüfter auf 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Relative Geschwindigkeit festlegen

Für diesen Befehl sind folgende Attribute erforderlich:
{
  "commandOnlyFanSpeed": true
}

Parameter

Die Nutzlast enthält einen der folgenden Werte:

Relative Geschwindigkeit nach Gewicht festlegen

Parameter Typ Beschreibung
fanSpeedRelativeWeight Ganzzahl

Erforderlich.

Dieser Wert gibt den relativen Wert der Geschwindigkeitsänderung an. Der Absolutwert gibt den skalierten Betrag an, während das numerische Vorzeichen die Richtung der Änderung angibt.

Legen Sie die relative Geschwindigkeit nach Prozentsatz fest.

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert entspricht dem Prozentsatz der Geschwindigkeit, die geändert werden soll.

Beispiele

Dreh die Lüftung gering.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Lüftergeschwindigkeit um 10 % erhöhen

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Lüfterrichtung umkehren.

Für diesen Befehl sind folgende Attribute erforderlich:
{
  "reversible": true
}

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Drehrichtung des Ventilators umkehren.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Beispieläußerungen

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • Absinken Lüftergeschwindigkeit des AC mittel

es-ES

  • cambia la velocidad del ventilador a Medio

fr-FR

  • Erfüllt die maximale

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen
  • maxSpeedReached: Das Gerät ist bereits auf die maximale Geschwindigkeit eingestellt.
  • minSpeedReached: Das Gerät ist bereits auf die Mindestgeschwindigkeit eingestellt.