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-Verläufe im Smart Home

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

Die Lüftergeschwindigkeit (d. h., das Gerät auf verschiedenen Ebenen Luft bläst, kann Teil einer Klimaanlage oder Heizung oder in einem Auto sein) kann Einstellungen wie „Niedrig“, „Mittel“ und „Hoch“ oder einen Prozentsatz enthalten.

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

(Standard: false)

Wenn „true“ festgelegt ist, unterstützt dieses Gerät den Lüfter in beide Richtungen und kann den Befehl zum Umkehren der Lüftung akzeptieren.

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

Enthält die 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

Geschwindigkeitseinstellung.

speed_name String

Erforderlich.

Interner Name der Geschwindigkeitseinstellung. Diese Funktion kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.

speed_values Array

Erforderlich.

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

[item, ...] Objekt

Synonym für die Geschwindigkeitseinstellung in einer bestimmten Sprache.

speed_synonym Array

Erforderlich.

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

[item, ...] String

Synonym.

lang String

Erforderlich.

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

ordered Boolesch

Erforderlich.

Wenn die Richtlinie auf „true“ gesetzt ist, wird eine zusätzliche Grammatik für die Logik zum Erhöhen oder Verringern in der Reihenfolge des Geschwindigkeitsarrays angewendet.

1 Objekt

Unterstützung für Geschwindigkeit in Prozent.

supportsFanSpeedPercent Boolesch

Erforderlich.

(Standard: false)

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

Beispiele

Gerät mit zwei Geschwindigkeitseinstellungen, Unterstützung für Umkehrrichtung 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 Zustände 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 Attribut supportsFanSpeedPercent 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:

Geschwindigkeit nach Einstellungen festlegen.

Parameter Typ Beschreibung
fanSpeed String

Erforderlich.

Die angeforderten Geschwindigkeitseinstellungen des Lüfters.

Geschwindigkeit nach Prozentsatz festlegen.

Parameter Typ Beschreibung
fanSpeedPercent Number

Erforderlich.

Der angeforderte Prozentsatz für die Geschwindigkeitseinstellung.

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 die folgenden 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 die relative Geschwindigkeitsänderung an. Der absolute Wert gibt den skalierten Betrag an, während das numerische Vorzeichen die Richtung der Änderung angibt.

Relative Geschwindigkeit nach Prozentsatz festlegen.

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert steht für die prozentuale Änderung der Geschwindigkeit.

Beispiele

Stell die Lüftung etwas geringer ein.

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

Erhöhe die Lüftung um 10 %.

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

action.devices.commands.Reverse

Lüfterrichtung umkehren.

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

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Drehrichtung umkehren.

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

Beispieläußerungen

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten medel

Gerät ERRORS

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