歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

智慧型住宅 FanSpeed 特性

action.devices.traits.FanSpeed - 這個特性包含支援風扇轉速的裝置。

風扇速度 (也就是在不同裝置上將裝置吹氣的程度 (可能是空調、暖氣、車用的一部分,或是車內) 可能包含低、中、高、高百分比等設定。

裝置屬性

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

屬性 類型 說明
reversible 布林

(預設:false)

如果設為 true,本裝置支援將兩個方向朝風扇吹開,然後接受指令來反轉風扇方向。

commandOnlyFanSpeed 布林

(預設:false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。

包含下列任何項目:
0 物件

支援速度設定。

availableFanSpeeds 物件

必填。

裝置支援的速度設定。

speeds 陣列

必填。

速度設定清單。

[item, ...] 物件

速度設定。

speed_name 字串

必填。

速度設定的內部名稱。這項功能不容易理解,並且會提供給所有語言。

speed_values 陣列

必填。

各個支援語言中速度設定的同義詞。

[item, ...] 物件

同一種語言速度的同義詞。

speed_synonym 陣列

必填。

速度設定的同義詞 (如果有的話) 應包含單數和複數形式 (如果有的話)。系統會將清單中第一個同義詞視為速度設定的標準名稱。

[item, ...] 字串

同義詞。

lang 字串

必填。

語言代碼 (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
}

裝置狀態:STATE

具有此特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱意圖執行要求一文。

類型 說明
currentFanSpeedSetting 字串

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

currentFanSpeedPercent Number

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

範例

客廳的風扇速度有多快?

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

裝置指令

具有此特性的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱意圖執行要求一文。

action.devices.commands.SetFanSpeed

設定速度。

參數

酬載包含下列其中一個值:

依設定調整速度。

參數 類型 說明
fanSpeed 字串

必填。

風扇要求的速度設定。

依百分比設定速度。

參數 類型 說明
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 medel

裝置錯誤:ERRORS

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