智慧型住宅切換交易結構定義
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 |
布林 |
(預設值: 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法針對此特性回應 QUERY 意圖或報告狀態,請將這項屬性設為 true。 |
queryOnlyToggles |
布林 |
(預設值: 如果裝置支援「僅限查詢」執行作業,則為必要欄位。這項屬性可指出裝置只能查詢狀態資訊,且無法控制。 |
範例
具備多個切換按鈕的裝置
{ "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 |
物件 |
必要。 鍵/值組合與做為切換裝置的「 |
<string> |
布林 |
目前的切換狀態。 |
範例
開啟環境化功能了嗎?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
裝置指令
具有此特性的裝置可能會回應 EXECUTE
作業中的下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求。
action.devices.commands.SetToggles
設定指定的切換狀態。
參數
參數 | 類型 | 說明 |
---|---|---|
updateToggleSettings |
物件 |
必要。 鍵/值組合與裝置的切換鈕 ( |
<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