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

智慧型住宅切換 Titit 結構定義

action.devices.traits.Toggles - 此屬性屬於任何屬於設定狀態的裝置,只能同時處於以下兩個狀態之一。

這些設定可以代表有開啟/關閉或有效/無效狀態的實體按鈕、在 HTML 中勾選核取方塊,或是任何特別已啟用/停用的元素。如果該設定包含兩個以上的狀態,或是有一個並未選取二元期權的狀態,則它應以 Modes 特性表示。這就相當於多狀態撥號、圓形按鈕 (物理或 HTML),或未明確開啟/關閉的二進位狀態 (例如「AM/FM」或「hot/cold」)。

此特徵涵蓋一或多個使用者可切換的開關。一般來說,這些開關應用於與其他裝置行為取消連結的功能。已連結行為 (例如開啟或關閉裝置),應使用更具體的特性 (例如,特性 TemperatureSetting 中的 thermostatMode)。

裝置屬性

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

屬性 類型 說明
availableToggles 陣列

必填。

可用切換按鈕。

[item, ...] 物件

可用的切換按鈕。

name 字串

必填。

切換按鈕的內部名稱,將在指令和狀態中使用。這項功能不容易理解,並且會提供給所有語言。

name_values 陣列

必填。

各語言的切換開關同義詞。

[item, ...] 物件

切換語言的同義詞。

name_synonym 陣列

必填。

切換按鈕的同義詞。系統會將這個清單的第一個字串用做該語言的層級標準名稱。

[item, ...] 字串

同義詞名稱。

lang 字串

必填。

語言代碼 (ISO 639-1)。詳情請參閱支援的語言

commandOnlyToggles 布林

(預設:false)

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

queryOnlyToggles 布林

(預設:false)

如果裝置支援查詢功能,則為必要屬性。這個屬性可指出裝置是否只能查詢狀態資訊,而且無法控制。

範例

支援多種切換裝置的裝置。

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

僅限指令的開關。

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

只有查詢切換鈕的裝置。

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

裝置狀態:STATE

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

類型 說明
currentToggleSettings 物件

必填。

鍵/值組合,裝置的開關 name 為鍵,而目前狀態作為值。

<string> 布林

目前的切換狀態。

範例

防震功能是否已開啟?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

裝置指令

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

action.devices.commands.SetToggles

設定指定的切換狀態。

參數

參數 類型 說明
updateToggleSettings 物件

必填。

鍵/值組合,裝置的開關 name 做為鍵,新狀態則是值。

<string> 布林

新增切換狀態

範例

開啟節能功能。

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

關閉篩選器。

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

話語範例

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • activate power freeze for the freezer
  • cancel power cool for the kitchen fridge

es-ES

  • pon el enfriamiento rápido en la nevera
  • quita el enfriamiento rápido

fr-FR

  • mets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

hi-IN

  • रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
  • रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

  • disattiva il power freeze del freezer
  • imposta la funzione power freeze del surgelatore

ja-JP

  • 冷蔵庫 急速冷凍 つけて
  • 冷蔵庫 急速冷凍 を切ってくれる

ko-KR

  • 냉장고 급속 냉장 해제해
  • 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

  • Zet de power cool uit op de koelkast
  • zet de koelkast op superkoelen

pt-BR

  • Ativa a função power freeze no congelador .
  • Desativa o bloqueio infantil do forno .
  • desligar o power cool da geladeira
  • iniciar o modo power freeze do freezer

sv-SE

  • Stäng av power cool i kylskåpet
  • sätt på power freeze frysen

裝置錯誤:ERRORS

請參閱錯誤和例外狀況的完整清單。