智慧型住宅起始站點結構定義
action.devices.traits.StartStop
- 這個特性屬於支援啟動和停止作業的裝置。
啟動及停止裝置會提供類似功能,讓使用者開啟或關閉裝置。開啟和啟動裝置時,沿用該特徵的方法會有所不同。舉例來說,某些洗衣機可以啟動,並在實際開始運作前修改相關設定。
與僅處於開啟和關閉狀態的裝置不同,部分裝置在啟動作業時也可以暫停和停止。可以暫停的裝置會停止作業,但是在恢復時,會維持與暫停期間相同的狀態。取消暫停與重新啟動的方式不同 (無論裝置目前狀態為何),只要從頭開始即可執行作業。
部分裝置可能支援在特定區域執行。舉例來說,灑水器可能設有不同的澆水區,並支援個別喝水區,吸塵器則可能支援清潔特定房間。
裝置屬性
具此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求。
屬性 | 類型 | 說明 |
---|---|---|
pausable |
布林 |
(預設值: 指出裝置可在作業期間暫停。 |
availableZones |
陣列 |
表示支援的可用區名稱。字串應根據使用者設定本地化。這份清單可能不是專屬項目,使用者可以回報想要的名稱。 |
[item, ...] |
字串 |
支援啟動裝置的區域名稱。 |
範例
可暫停並支援在多個可用區運作的裝置。
{ "pausable": true, "availableZones": [ "Kitchen", "Living room", "Office", "Bedroom" ] }
裝置狀態
具有這個特性的實體可能會在 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 |
布林 |
必要。 設為暫停;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
- ist die Waschmaschine fertig
en-US
- I need my roomba to start running in the den
- is the vacuum running
- pause the dryer now
- start the dryer now
- stop the dishwasher
- unpause the dishwasher
es-ES
- dime si ha acabado el lavavajillas
- parar la lavadora
- pon el lavavajillas en pausa
- quiero usar el friegaplatos
- vuelve a encender la aspiradora
fr-FR
- Allumer l'aspirateur dans le salon .
- Continuer l'aspirateur .
- arrête l'aspirateur
- est-ce que l'aspirateur est en marche
- 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
- la lavatrice è in funzione
- metti in pausa l'aspirapolvere
- stoppa l'aspirapolvere
ja-JP
- お掃除ロボット を リビング で動かして
- 台所の食洗機 を一時停止してください
- 掃除機 は作動してる
- 掃除機 を停止して
- 掃除機 を再開してください
- 洗濯機 をスタートさせて
ko-KR
- 거실 에서 청소기 돌려
- 건조기 돌아가고 있나
- 세탁기 좀 돌려 줘
- 식기 세척기 다시 시작해
- 청소기 일시 정지
- 청소기 작동 멈춰 줘
nl-NL
- De schoonmaakrobot inschakelen in de keuken .
- Is de stofzuiger klaar
- hervat de stofzuiger
- pauzeer de stofzuiger
- start mijn stofzuiger
- stop de stofzuiger
pt-BR
- Inicia o aspersor no jardim
- Iniciar o aspirador de pó na sala .
- iniciar a máquina de lavar
- o aspirador está parado?
- 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 .
- har dammsugaren i vardagsrummet startat?
- kör igång dammsugaren igen
- pausa dammsugaren
- starta tvättmaskinen
- stoppa dammsugaren