智慧型住宅風扇轉速特徵架構

action.devices.traits.FanSpeed - 這項特徵屬於支援設定風扇速度的裝置。

風扇轉速 (即裝置以不同程度吹出空氣，可能屬於空調或暖氣裝置，或位於車內)，可能包括低、中、高或百分比等設定。

裝置屬性

具有這項特徵的裝置可能會回報下列屬性，做為 SYNC 作業的一部分。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。

屬性 類型 說明
reversible 布林值

(預設值：false)

如果設為 True，表示裝置支援雙向吹風，且可接受反向吹風的指令。
commandOnlyFanSpeed 布林值

(預設值：false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應這項特徵的 QUERY 意圖或 Report State，請將這個屬性設為 true。
含有下列任一項目：
0 物件

支援速度設定。
availableFanSpeeds 物件

必要。

裝置支援的速度設定。
speeds 陣列

必要。

速度設定清單。
[item, ...] 物件

速度設定。
speed_name String

必要。

速度設定的內部名稱。這可能不適合使用者，而且會以所有語言分享。
speed_values 陣列

必要。

各支援語言的語速設定同義詞。
[item, ...] 物件

特定語言的語速設定同義詞。如要提供語言備用選項，至少須有一個項目的 lang 值為 en。
speed_synonym 陣列

必要。

速度設定的同義詞應包含單數和複數形式 (如適用)。清單中的第一個同義字會視為速度設定的標準名稱。
[item, ...] String

同義詞。如要提供語言備用選項，至少須有一個項目的 lang 值為 en。
lang String

必要。

語言代碼 (ISO 639-1)。請參閱支援的語言。
ordered 布林值

必要。

如果設為 true，系統會套用額外的文法，以速度陣列的順序 (遞增) 進行增加或減少邏輯。
1 物件

支援速度百分比。
supportsFanSpeedPercent 布林值

必要。

(預設值：false)

如果設為 true，裝置會接受調整速度的指令，調整範圍為 0.0 到 100.0 的百分比。

範例

裝置提供兩種速度設定，支援反向和百分比調整。

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

裝置狀態

具有這項特徵的實體可能會回報下列狀態，做為 QUERY 作業的一部分。如要進一步瞭解如何處理 QUERY 意圖，請參閱「意圖執行要求」。

州 類型 說明
currentFanSpeedSetting String

這代表 availableFanSpeeds 屬性中目前速度設定的內部名稱。
currentFanSpeedPercent Number

以百分比表示目前的風扇轉速。如果 supportsFanSpeedPercent 屬性設為 true，則為必要屬性

範例

客廳風扇的風速是多少？

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

裝置指令

具有這項特徵的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱「意圖執行要求」。

action.devices.commands.SetFanSpeed

設定速度。

參數

酬載包含下列其中一項：

透過設定調整速度。

參數 類型 說明
fanSpeed String

必要。

風扇要求的速度設定。

以百分比設定速度。

參數 類型 說明
fanSpeedPercent Number

必要。

要求的速度設定百分比。

範例

將風扇調到高速。

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

將風扇設為 50%。

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

action.devices.commands.SetFanSpeedRelative

設定相對速度。

這項指令需要下列屬性： 
{
  "commandOnlyFanSpeed": true
}

參數

酬載包含下列其中一項：

依權重設定相對速度。

參數 類型 說明
fanSpeedRelativeWeight 整數

必要。

這個值表示速度變化的相對量。絕對值表示縮放量，數字符號則表示變更方向。

以百分比設定相對速度。

參數 類型 說明
fanSpeedRelativePercent Number

必要。

這個值代表速度變化的百分比。

範例

稍微降低風扇轉速。

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

將風扇速度調高 10%。

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

action.devices.commands.Reverse

反轉風扇方向。

這項指令需要下列屬性： 
{
  "reversible": true
}

參數

參數 類型 說明

沒有任何屬性

範例

反轉風扇方向。

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

語音指令範例

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

裝置錯誤

如需完整清單，請參閱錯誤和例外狀況。
  • maxSpeedReached：裝置已設為最高速。
  • minSpeedReached：裝置已設為最低速。