智慧型住宅起始站點結構定義

action.devices.traits.StartStop - 這個特性屬於支援啟動和停止作業的裝置。

啟動及停止裝置會提供類似功能，讓使用者開啟或關閉裝置。開啟和啟動裝置時，沿用該特徵的方法會有所不同。舉例來說，某些洗衣機可以啟動，並在實際開始運作前修改相關設定。

與僅處於開啟和關閉狀態的裝置不同，部分裝置在啟動作業時也可以暫停和停止。可以暫停的裝置會停止作業，但是在恢復時，會維持與暫停期間相同的狀態。取消暫停與重新啟動的方式不同 (無論裝置目前狀態為何)，只要從頭開始即可執行作業。

部分裝置可能支援在特定區域執行。舉例來說，灑水器可能設有不同的澆水區，並支援個別喝水區，吸塵器則可能支援清潔特定房間。

裝置屬性

具此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求。

屬性	類型	說明
pausable	布林	(預設值：false) 指出裝置可在作業期間暫停。
availableZones	陣列	表示支援的可用區名稱。字串應根據使用者設定本地化。這份清單可能不是專屬項目，使用者可以回報想要的名稱。
[item, ...]	字串	支援啟動裝置的區域名稱。

範例

可暫停並支援在多個可用區運作的裝置。

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

裝置狀態

具有這個特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱意圖執行要求。

州	類型	說明
isRunning	布林	必要。 指出裝置是否正在執行。
isPaused	布林	表示裝置是否已遭明確暫停。如果這個值為 true，表示 isRunning 為 false，但可以重新啟用。
activeZones	陣列	表示裝置目前正在執行的可用區，請查看 availableZones 清單。
[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	陣列	指示兩個以上的開始執行的區域。將設為zone parameter.，而不是
[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

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。