智慧型住宅 StartStop Trait 結構定義
action.devices.traits.StartStop
- 此屬性屬於支援開始及停止操作的裝置。
啟動及停止裝置時,其功能與開啟及關閉類似。在裝置啟動後,以不同方式繼承這個特性的功能。例如,某些洗衣機可以在啟用實際啟動前能開啟及修改設定。
有些裝置在啟動和關閉狀態不直接,因此有些啟動和停止的裝置也可以在執行作業時暫停。可暫停的裝置會停止作業,但在繼續時,將保持與暫停狀態相同的狀態。無論裝置目前的狀態為何,取消暫停和開始/重新啟動皆不同,這會從頭開始作業。
部分裝置可能支援在特定區域執行。舉例來說,灑水器可能會有多個不同的澆水區,並分別支援特定水域的水位;吸塵器則可能能夠清潔特定房間。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
pausable |
布林 |
(預設: 指出裝置是否可在作業過程中暫停。 |
availableZones |
陣列 |
表示支援的可用區名稱。字串應根據使用者設定,提供本地化版本。這份清單並非專門的,因此使用者可以回報任何名稱。 |
[item, ...] |
字串 |
支援啟動裝置的區域名稱。 |
範例
可在多個區域暫停及支援運作的裝置。
{ "pausable": true, "availableZones": [ "kitchen", "living room", "office", "bedroom" ] }
裝置狀態:STATE
具有此特性的裝置可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
isRunning |
布林 |
必填。 指出裝置是否處於運作中。 |
isPaused |
布林 |
指出裝置是否已明確暫停。如果這個值為 True,表示 |
activeZones |
陣列 |
從 |
[item, ...] |
字串 |
區域名稱。 |
範例
裝置已暫停嗎?
{ "isRunning": false, "isPaused": true }
裝置已暫停嗎?
{ "isRunning": true, "isPaused": false }
裝置是否正在運作?
{ "isRunning": true, "isPaused": false, "activeZones": [ "kitchen", "living room" ] }
裝置指令
具有此特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求一文。
action.devices.commands.StartStop
啟動或停止裝置。
參數
參數 | 類型 | 說明 |
---|---|---|
start |
布林 |
必填。 設為 True 可啟動裝置作業,傳回 False 可停止。 |
zone |
字串 |
表示要開始執行的區域。 |
multipleZones |
陣列 |
表示開始運作的兩個或更多區域。將設為 |
[item, ...] |
字串 |
要啟動裝置的區域名稱。 |
範例
啟動裝置。
{ "command": "action.devices.commands.StartStop", "params": { "start": true } }
停止裝置。
{ "command": "action.devices.commands.StartStop", "params": { "start": false } }
在辦公室啟動裝置。
{ "command": "action.devices.commands.StartStop", "params": { "start": true, "zone": "office" } }
在廚房、用餐室和客廳啟動裝置。
{ "command": "action.devices.commands.StartStop", "params": { "start": true, "multipleZones": [ "kitchen", "dining room", "living room" ] } }
action.devices.commands.PauseUnpause
暫停或取消暫停裝置作業。
這個指令需要下列屬性:{ "pausable": true }
參數
參數 | 類型 | 說明 |
---|---|---|
pause |
布林 |
必填。 設為 True 可暫停,設為 False 可取消暫停。 |
範例
暫停裝置。
{ "command": "action.devices.commands.PauseUnpause", "params": { "pause": true } }
相關錯誤
使用者嘗試暫停裝置,但裝置處於無法暫停的狀態。
支援的值:
unpausableState
話語範例
de-DE
-
Bitte starte
den Staubsauger im Wohnzimmer . -
Geschirrspüler wieder anstellen -
Staubsauger abschalten -
Staubsauger pausieren -
bitte starte
die Waschmaschine
en-US
-
I need
my roomba to start running inthe den -
pause
the dryer now -
start
the dryer now -
stop
the dishwasher -
unpause
the dishwasher
es-ES
-
parar
la lavadora -
pon
el aspirador enel dormitorio principal -
pon
el lavavajillas en pausa -
quiero usar
el friegaplatos -
vuelve a encender
la aspiradora
fr-FR
-
Allumer
l'aspirateur dansle salon . -
Continuer
l'aspirateur . -
arrête
l'aspirateur -
lance
la machine à laver -
mets
l'aspirateur en pause
hi-IN
-
कमरे मेंवैक्यूम चलाओगी -
डिशवॉशर को कुछ देर रोको -
वैक्यूम को अनपॉज़ करो -
वैक्यूम को चालू कर दो -
वैक्यूम को बंद कर दो
it-IT
-
Mi accendi
l'aspirapolvere in cucina ? -
fa' partire
aspirapolvere -
fai ripartire
l'aspirapolvere -
metti in pausa
l'aspirapolvere -
stoppa
l'aspirapolvere
ja-JP
-
お掃除ロボット をリビング で動かして -
台所の食洗機 を一時停止してください -
掃除機 を停止して -
掃除機 を再開してください -
洗濯機 をスタートさせて
ko-KR
-
거실 에서청소기 돌려 -
세탁기 좀 돌려 줘 -
식기 세척기 다시 시작해 -
청소기 일시 정지 -
청소기 작동 멈춰 줘
nl-NL
-
De schoonmaakrobot inschakelen inde keuken . -
hervat
de stofzuiger -
pauzeer
de stofzuiger -
start
mijn stofzuiger -
stop
de stofzuiger
pt-BR
-
Inicia
o aspersor nojardim -
Iniciar
o aspirador de pó nasala . -
iniciar
a máquina de lavar -
parar a pausa na
máquina de lavar roupa -
parar
o aspirador de pó -
pausar
o aspirador de pó
sv-SE
-
Kör igång
sprinklern pågräsmattan . -
kör igång
dammsugaren igen -
pausa
dammsugaren -
starta
tvättmaskinen -
stoppa
dammsugaren