智慧型住宅 StartStop 特徵結構定義

action.devices.traits.StartStop - 支援啟動和停止作業的裝置具備這項特徵。

啟動和停止裝置的功能與開啟和關閉裝置類似。繼承這項特徵的裝置在開啟和啟動時，運作方式有所不同。舉例來說，某些洗衣機可以在實際啟動前開啟電源並修改設定。

有些裝置不僅能啟動和停止，還能在執行作業時暫停，不像只能開啟和關閉的裝置。可暫停的裝置會停止運作，但恢復後會繼續執行暫停前的狀態。取消暫停與啟動/重新啟動不同，因為無論裝置目前處於何種狀態，都會從頭開始運作。

部分裝置可能支援在特定區域跑步。舉例來說，灑水器可能有多個灑水區，並支援分別為特定區域灑水；吸塵器則可能支援清潔特定房間。

裝置屬性

具有這項特徵的裝置可能會回報下列屬性，做為 SYNC 作業的一部分。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。

屬性 類型 說明
pausable 布林值

(預設值：false)

指出裝置是否能在作業期間暫停。
availableZones 陣列

指出支援的區域名稱。字串應根據使用者設定進行本地化。這份清單僅列舉部分名稱，使用者可以檢舉任何名稱。
[item, ...] String

支援啟動裝置的區域名稱。

範例

可暫停且支援在多個區域運作的裝置。

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

裝置狀態

具有這項特徵的實體可能會回報下列狀態，做為 QUERY 作業的一部分。如要進一步瞭解如何處理 QUERY 意圖，請參閱「意圖執行要求」。

州 類型 說明
isRunning 布林值

必要。

指出裝置目前是否正在運作。
isPaused 布林值

指出裝置是否已明確暫停。如果這個值為 true，表示 isRunning 為 false，但可以繼續。如果 isPaused 為 false，則欄位應只從 QUERY 或「報表狀態」傳回，但不得同時從兩者傳回。如果兩者都傳回 is_paused，可能會因狀態差異而導致報表狀態不準確。
activeZones 陣列

指出裝置目前執行的區域 (來自 availableZones 清單)。
[item, ...] String

區域名稱。

範例

裝置是否已暫停？

{
  "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 String

指出要開始執行的區域。
multipleZones 陣列

指出要開始執行的兩個以上區域。會改為設定，而非 zone parameter.
[item, ...] String

要啟動裝置的區域名稱。

範例

啟動裝置。

{
  "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
  • 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

裝置錯誤

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