智慧住宅模式特性架構
action.devices.traits.Modes
- 此屬性涵蓋裝置的所有可用模式和模式專屬設定。
此特性屬於任何具有任意數量「n-way」模式的裝置,其中每種模式的模式和設定在任何裝置或裝置類型上均不重複。每種模式都有多種可能的設定,但一次只能選取一個設定;烘乾機不得同時採用「穩定」、「正常」和「重型」模式。可以開啟或關閉的設定屬於「Toggles」特徵。
舉例來說,洗衣機可以設定負載和溫度設定。 這兩種模式都可以彼此獨立運作,但每個模式一次只能處於一種狀態。使用者可以透過類似將洗衣機的溫度設為冷氣的指令明確設定溫度等模式。
部分模式為「排序」,還可以使用上調/調低/減少動詞。舉例來說,載入大小 (小、中、大) 和溫度有明確排列 (請注意,溫度不是像數字目標的實際溫度一樣,不會像其他裝置一樣),但是載入類型 (熱度、正常、羊毛等) 則未必會有序。
此特徵涵蓋一或多個可供使用者設定的個別模式。一般來說,這些模式應用於與其他裝置行為取消連結的功能。已連結行為 (例如開啟或關閉裝置本身) 應使用更具體的特性 (例如,特性 TemperatureSetting 中的 thermostatMode
)。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
availableModes |
陣列 |
必填。 可用模式清單。 |
[item, ...] |
物件 |
可用的模式。 |
name |
字串 |
必填。 模式的內部名稱,將在指令和狀態中使用。這項功能不容易理解,並且會提供給所有語言。 |
name_values |
陣列 |
必填。 每種支援的語言的模式同義詞。 |
[item, ...] |
物件 |
特定語言的同義詞。 |
name_synonym |
陣列 |
必填。 模式的同義詞。系統會將這個清單的第一個字串用做該語言的層級標準名稱。 |
[item, ...] |
字串 |
同義詞名稱。 |
lang |
字串 |
必填。 語言代碼 (ISO 639-1)。詳情請參閱支援的語言。 |
settings |
陣列 |
必填。 此模式支援的設定。 |
[item, ...] |
物件 |
支援的設定。 至少要有 2 個項目。 |
setting_name |
字串 |
必填。 模式設定的內部名稱,將在指令和狀態中使用。這項功能不容易理解,並且會提供給所有語言。 |
setting_values |
陣列 |
必填。 各個支援語言的設定同義詞。 |
[item, ...] |
物件 |
特定語言的設定同義詞。 |
setting_synonym |
陣列 |
必填。 設定的同義詞。系統會將這個清單的第一個字串用做該語言的層級標準名稱。 |
[item, ...] |
字串 |
同義詞名稱。 |
lang |
字串 |
必填。 語言代碼 (ISO 639-1)。詳情請參閱支援的語言。 |
ordered |
布林 |
(預設: 如果將值設為 True,系統會依設定陣列的順序 (遞增) 套用增加/減少邏輯的其他文法。 |
commandOnlyModes |
布林 |
(預設: 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。 |
queryOnlyModes |
布林 |
(預設: 如果裝置支援查詢功能,則為必要屬性。這個屬性可指出裝置是否只能查詢狀態資訊,而且無法控制。 |
範例
有多種模式和設定的裝置。
{ "availableModes": [ { "name": "load_mode", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_load", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "medium_load", "setting_values": [ { "setting_synonym": [ "Medium", "Normal" ], "lang": "en" } ] }, { "setting_name": "large_load", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true }, { "name": "temp_mode", "name_values": [ { "name_synonym": [ "Temperature", "Temp" ], "lang": "en" } ], "settings": [ { "setting_name": "hot_temp", "setting_values": [ { "setting_synonym": [ "Hot", "White" ], "lang": "en" } ] }, { "setting_name": "warm_temp", "setting_values": [ { "setting_synonym": [ "Warm", "Color" ], "lang": "en" } ] }, { "setting_name": "cold_temp", "setting_values": [ { "setting_synonym": [ "Cold", "Delicate" ], "lang": "en" } ] } ], "ordered": false } ] }
僅限指令模式的裝置。
{ "availableModes": [ { "name": "light_mode", "name_values": [ { "name_synonym": [ "Light", "Lighting" ], "lang": "en" } ], "settings": [ { "setting_name": "day_light", "setting_values": [ { "setting_synonym": [ "Day", "Bright" ], "lang": "en" } ] }, { "setting_name": "night_light", "setting_values": [ { "setting_synonym": [ "Night", "Dark" ], "lang": "en" } ] }, { "setting_name": "reading_light", "setting_values": [ { "setting_synonym": [ "Reading", "Ambiant" ], "lang": "en" } ] } ], "ordered": false } ], "commandOnlyModes": true, "queryOnlyModes": false }
裝置狀態:STATE
具有此特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
currentModeSettings |
物件 |
必填。 鍵/值組合,裝置的模式 |
<string> |
字串 |
目前 |
範例
裝置目前處於哪種模式?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
裝置指令
具有此特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求一文。
action.devices.commands.SetModes
更新模式設定。
參數
參數 | 類型 | 說明 |
---|---|---|
updateModeSettings |
物件 |
必填。 鍵/值組合,裝置的模式 |
<string> |
字串 |
新增 |
範例
設為大負載。
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
話語範例
de-DE
-
Stelle
den Staubsauger aufRuhemodus
en-US
-
set
the vacuum toenergy saver mode
es-ES
-
pon
la lavadora en modofrío
fr-FR
-
mets
l'aspirateur ensilencieux
hi-IN
-
वैक्यूम परकार्पेट मोड लगाएं
it-IT
-
imposta
l'aspirapolvere susilenzioso
ja-JP
-
掃除機 を静音 モードに設定して
ko-KR
-
세탁기 세탁량 많음 으로 설정해
pt-BR
-
acionar a função
autolimpeza doaspirador -
ligar o modo de
aquecimento