Schema für die Lüftergeschwindigkeit von Smart Homes

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

Lüftergeschwindigkeiten (d. h. das Anblasen von Luft aus dem Gerät auf verschiedenen Stufen, das Teil eines Klimaanlage oder Heizung bzw. im Auto) können Einstellungen wie „Niedrig“, „Mittel“ und „Hoch“ enthalten. oder einen Prozentsatz.

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute Typ Beschreibung
reversible Boolesch

(Standardeinstellung: false)

Wenn die Richtlinie auf „true“ gesetzt ist, unterstützt dieses Gerät das Anblasen des Lüfters in beide Richtungen und akzeptiert den Befehl zum Umkehren der Lüfterrichtung.
commandOnlyFanSpeed Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsche) Kommunikation unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder „Report State“ für dieses Merkmal reagieren kann.
Enthält eines der folgenden Elemente:
0 Objekt

Geschwindigkeitseinstellungen werden unterstützt.
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. Dies 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 Geschwindigkeitseinstellung sollten gegebenenfalls sowohl Singular- als auch Pluralformen enthalten. Das erste Synonym in der Liste wird als kanonischer Name der Geschwindigkeitseinstellung betrachtet.
[item, ...] String

Synonym.
lang String

Erforderlich.

Sprachcode (ISO 639-1). Weitere Informationen zu unterstützten Sprachen
ordered Boolesch

Erforderlich.

Wenn dieser Wert auf „true“ gesetzt ist, wird zusätzliche Grammatik für die Logik zum Erhöhen oder Verringern in der Reihenfolge (Erhöhung) des Arrays „speeds“ angewendet.
1 Objekt

Unterstützung für Geschwindigkeitsprozentsatz.
supportsFanSpeedPercent Boolesch

Erforderlich.

(Standardeinstellung: false)

Wenn die Richtlinie auf „true“ gesetzt ist, akzeptiert das Gerät Befehle zur Anpassung der Geschwindigkeit in Prozent zwischen 0,0 und 100.

Beispiele

Gerät mit zwei Geschwindigkeitseinstellungen, Unterstützung für umgekehrte Richtungs- 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

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Bundesstaaten Typ Beschreibung
currentFanSpeedSetting String

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 hoch sind die Lüfter im Wohnzimmer?

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

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.SetFanSpeed

Geschwindigkeit festlegen.

Parameter

Die Nutzlast enthält eines der folgenden Elemente:

Du kannst die Geschwindigkeit anhand der Einstellungen festlegen.

Parameter Typ Beschreibung
fanSpeed String

Erforderlich.

Die angeforderten Geschwindigkeitseinstellungen des Lüfters.

Legen Sie die Geschwindigkeit in Prozent fest.

Parameter Typ Beschreibung
fanSpeedPercent Number

Erforderlich.

Der angeforderte Prozentsatz für die Geschwindigkeitseinstellung.

Beispiele

Stell die Lüftung auf die 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

Legen Sie die relative Geschwindigkeit fest.

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

Parameter

Die Nutzlast enthält eines der folgenden Elemente:

Legen Sie die relative Geschwindigkeit anhand des Gewichts fest.

Parameter Typ Beschreibung
fanSpeedRelativeWeight Ganzzahl

Erforderlich.

Dieser Wert gibt den relativen Wert der Geschwindigkeitsänderung an. Der absolute Wert gibt den skalierten Wert an, während das Zahlenzeichen die Richtung der Änderung angibt.

Legen Sie die relative Geschwindigkeit in Prozent fest.

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert gibt den Prozentsatz der Geschwindigkeit an, die geändert werden soll.

Beispiele

Stell die Lüftung etwas niedriger.

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

Erhöhe die Lüftergeschwindigkeit um 10 %.

{
  "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

Schiebe die Lüfterrichtung um.

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

Beispieläußerungen

<ph type="x-smartling-placeholder">

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 på medel

Gerätefehler

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.