歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

智慧型住宅 StartStop Trait 結構定義

action.devices.traits.StartStop - 此屬性屬於支援開始及停止操作的裝置。

啟動及停止裝置時,其功能與開啟及關閉類似。在裝置啟動後,以不同方式繼承這個特性的功能。例如,某些洗衣機可以在啟用實際啟動前能開啟及修改設定。

有些裝置在啟動和關閉狀態不直接,因此有些啟動和停止的裝置也可以在執行作業時暫停。可暫停的裝置會停止作業,但在繼續時,將保持與暫停狀態相同的狀態。無論裝置目前的狀態為何,取消暫停和開始/重新啟動皆不同,這會從頭開始作業。

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

裝置屬性

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

屬性 類型 說明
pausable 布林

(預設:false)

指出裝置是否可在作業過程中暫停。

availableZones 陣列

表示支援的可用區名稱。字串應根據使用者設定,提供本地化版本。這份清單並非專門的,因此使用者可以回報任何名稱。

[item, ...] 字串

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

範例

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

{
  "pausable": true,
  "availableZones": [
    "kitchen",
    "living room",
    "office",
    "bedroom"
  ]
}

裝置狀態:STATE

具有此特性的裝置可能會在 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 布林

必填。

設為 True 可暫停,設為 False 可取消暫停。

範例

暫停裝置。

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

使用者嘗試暫停裝置,但裝置處於無法暫停的狀態。

支援的值:

unpausableState

話語範例

de-DE

  • Bitte Starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler 維德阿森納
  • Staubsauger abschalten
  • Staubsauger 佩斯琳
  • 咬字開頭 die Waschmaschine

en-US

  • 我需要 myroombaden
  • 立即暫停 烘乾機 立即
  • 立即展開烘乾機
  • 洗碗機
  • 取消暫停洗碗機

es-ES

  • parar la lavadora
  • pon el aspirador en el dormitorio principal
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • 拉美斯拉夫

fr-FR

  • Allumer l'aspirateur dans le salon .
  • 繼續 l'aspirateur .
  • arrête l'aspirateur
  • 外型 lala à laver
  • 符合 l'aspirateur 暫停

裝置錯誤:ERRORS

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