智慧型住宅切換 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 |
布林 |
(預設: 指出裝置是否支援單向 (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 }
裝置狀態:STATE
具有此特性的實體可能會在 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 aufPower Cool
en-US
-
activate
power freeze forthe freezer -
cancel
power cool forthe kitchen fridge
es-ES
-
pon el
enfriamiento rápido enla nevera -
quita el
enfriamiento rápido
fr-FR
-
mets le mode
power cool surle réfrigérateur -
Éteins le mode
power freeze duré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 opde koelkast -
zet
de koelkast opsuperkoelen
pt-BR
-
Ativa a função
power freeze nocongelador . -
Desativa o
bloqueio infantil doforno . -
desligar o
power cool dageladeira -
iniciar o modo
power freeze dofreezer
sv-SE
-
Stäng av
power cool ikylskåpet -
sätt på
power freeze påfrysen