智慧型住宅切換交易結構定義

action.devices.traits.Toggles - 這項特性有任一裝置屬於只能在兩個狀態之間存在的設定，

這些設定可呈現具有開啟/關閉或啟用/停用狀態的實體按鈕、HTML 中的核取方塊，或任何其他已啟用/停用元素的元素。如果設定超過兩個狀態，或狀態皆未選取二進位選項，最好以「模式」特性表示，相當於多狀態電話、圓形按鈕 (實體或 HTML)，或未明確開啟/關閉的二進位檔狀態 (例如「AM/FM」或「熱/冷」)。

這個特性涵蓋一或多個使用者可以設定的切換鈕。一般而言，這些切換按鈕應用於與其他裝置行為取消連結的功能。連結行為 (例如開啟或關閉裝置本身) 應使用更具體的特性 (例如，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
}

裝置狀態

具有這個特性的實體可能會在 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 på frysen

裝置 ERRORS

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