智慧型住宅 FanSpeed 特徵結構定義

action.devices.traits.FanSpeed：此特徵屬於可設定風扇速度的裝置。

風扇轉速 (也就是在不同程度下從裝置吹出空氣，可能屬於空調或暖氣設備的一部分，或在車內) 可能包含低、中、高或百分比等設定。

裝置屬性

具備此特徵的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。

屬性 類型 說明
reversible 布林值

(預設值：false)

如果設為 true，此裝置可對左右風扇吹氣，並接受指令來反向風扇方向。
commandOnlyFanSpeed 布林值

(預設值：false)

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

支援速度設定。
availableFanSpeeds 物件

必填。

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

必要。

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

速度設定。
speed_name String

必要。

速度設定的內部名稱。這可能會對使用者造成不便，且會在所有語言中共用。
speed_values 陣列

必要。

速度設定在各個支援語言中的同義字。
[item, ...] 物件

特定語言中速度設定的同義詞。
speed_synonym 陣列

必填。

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

同義詞。
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

裝置 ERRORS

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