智慧型住宅粉絲速度特徵結構定義

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

裝置錯誤

查看完整清單 錯誤和例外狀況。
  • maxSpeedReached：裝置已設在最高速度。
  • minSpeedReached：裝置已設為最低速度。