Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Informationen über Smart-Home-Aktionen. Hinweis:Die Aktionen in der Actions Console werden weiterhin erstellt.

Schema der FanSpeed-Smart-Home-Steuerung

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

Lüftergeschwindigkeiten (das Blasen von Luft aus dem Gerät auf verschiedenen Ebenen, z. B. in einer Klimaanlage, einer Heizung oder in einem Auto) können Einstellungen wie „Niedrig“, „Mittel“ und „Hoch“ oder einen Prozentsatz enthalten.

Geräte-ATTRIBUTE

Geräte mit diesem Merkmal können im Rahmen des SYNC-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
reversible Boolesch

(Standard: false)

Wenn die Einstellung auf „true“ gesetzt ist, unterstützt das Gerät den Lüfter in beide Richtungen und lässt den Befehl annehmen, um die Lüfterrichtung umzukehren.

commandOnlyFanSpeed Boolesch

(Standard: false)

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

Enthält eines der folgenden Elemente:
0 Objekt

Support für Geschwindigkeitseinstellungen.

availableFanSpeeds Objekt

Erforderlich.

Vom Gerät unterstützte Geschwindigkeitseinstellungen.

speeds Array

Erforderlich.

Liste der Geschwindigkeitseinstellungen.

[item, ...] Objekt

Geschwindigkeit festlegen.

speed_name String

Erforderlich.

Interner Name der Geschwindigkeitseinstellung. Das Spiel kann nicht nutzerfreundlich sein 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 Einstellung für die Geschwindigkeit sollten, falls zutreffend, sowohl Singular- als auch Pluralformen enthalten. Das erste Synonym in der Liste wird als kanonischer Name der Geschwindigkeitseinstellung betrachtet.

[item, ...] String

Synonyme.

lang String

Erforderlich.

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

ordered Boolesch

Erforderlich.

Wird die Richtlinie auf „true“ gesetzt, wird eine zusätzliche Grammatik für die Logik zur Erhöhung oder Verringerung in der Reihenfolge des Speeds-Arrays angewendet (steigend).

1 Objekt

Unterstützung für Geschwindigkeitsprozentsatz.

supportsFanSpeedPercent Boolesch

Erforderlich.

(Standard: false)

Wenn du den Wert auf „true“ setzt, akzeptiert das Gerät Befehle zum Anpassen 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ätestatus

Entitäten mit diesem Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von 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 gesetzt ist

Beispiele

Welche Geschwindigkeit haben die Fans im Wohnzimmer?

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

BEISPIELE für Geräte

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.SetFanSpeed

Geschwindigkeit festlegen

Parameter

Die Nutzlast enthält eine der folgenden Optionen:

Geschwindigkeit nach Einstellungen festlegen.

Parameter Typ Beschreibung
fanSpeed String

Erforderlich.

Angeforderte Geschwindigkeitseinstellungen des Lüfters

Geschwindigkeit nach Prozentsatz festlegen.

Parameter Typ Beschreibung
fanSpeedPercent Number

Erforderlich.

Angeforderte Geschwindigkeitseinstellung in Prozent

Beispiele

Stell den Lüfter auf hoch.

{
  "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 eine der folgenden Optionen:

Legen Sie die relative Geschwindigkeit nach Gewicht fest.

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 Zeichen die Richtung der Änderung angibt.

Legen Sie die relative Geschwindigkeit in Prozent fest.

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert stellt die prozentuale Geschwindigkeit dar, die geändert werden soll.

Beispiele

Die Lüftung langsamer verringern.

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

Die Lüftergeschwindigkeit lässt sich um 10 % erhöhen.

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

action.devices.commands.Reverse

Richtung des Lüfters umkehren.

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

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Die Lüfterrichtung 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

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.
  • maxSpeedReached: Das Gerät ist bereits auf die höchste Geschwindigkeit eingestellt.
  • minSpeedReached: Das Gerät ist bereits auf die minimale Geschwindigkeit eingestellt.