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

智慧型住宅 RunCycle 結構定義

action.devices.traits.RunCycle - 此特性代表任何可持續運作的裝置待查詢的裝置;

這類裝置會回報裝置啟動時開始運作的週期總數,以及裝置目前正在執行的各個週期。可讓使用者查詢,例如:

  • 我的乾衣機循環?
  • 洗碗機還剩下幾個週期?
  • 乾衣機是什麼?
  • 何時開始清洗?

某些裝置包含非週期性格式的時間長度。任何裝置只要執行特定時間長度的裝置,即可回報剩餘時間。這也可處理週期可能不一致的情況 (例如,洗碗機不一定每次都會使用所有週期)。舉例來說,使用者可以詢問「我的吸塵器需要多久?」,它會傳回與剩餘時間相異的單位時間。這也適用於上述裝置;我的衣物烘乾需要多久?會傳回幾分鐘。

裝置可以傳回哪些資訊,而 Google 助理 TTS 的回應就會根據可用資料建立最佳答案 (例如洗碗機正在運作,大約 20 分鐘內就能完成)。

RunCycle 目前是唯讀特性,不含任何指令,只有可查詢的狀態。日後,系統可能會有重新執行週期或略過週期的機制 (適用於灑水器,適合用洗衣機使用)。

裝置屬性

裝置狀態

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

類型 說明
currentRunCycle 陣列

必填。

包含目前支援語言中各週期的同義詞。

[item, ...] 物件

週期同義詞名稱。

currentCycle String

必填。

正在執行目前的週期。

nextCycle String

選用,下一個待執行的週期。

lang String

必填。

指定週期名稱的語言代碼。請參閱支援的語言

currentTotalRemainingTime 整數

必填。

作業剩餘時間 (以秒為單位)。

currentCycleRemainingTime 整數

必填。

目前帳單週期的剩餘時間 (以秒為單位)。

範例

裝置隨後會額外清洗 5 分鐘,並在 20 分鐘內完成。

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

裝置將於另外 5 分鐘未恢復顯示,之後才會轉動。

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

裝置指令

裝置通知

設有此特性的裝置可能會隨著裝置狀態變更,傳回下列通知酬載。如要進一步瞭解如何導入通知,請參閱「智慧型住宅動作通知」。

欄位 類型 說明
RunCycle

必填。

通知酬載。

支援下列其中一項:
0 物件

成功

priority 整數

必填。

代表通知層級。目前支援的值為 0,表示應讓系統大聲朗讀通知。

status String

必填。

作業結果。

支援的值:

SUCCESS
currentCycleRemainingTime 整數

必填。

目前帳單週期的剩餘時間 (以秒為單位)。

1 物件

失敗

priority 整數

必填。

代表通知層級。目前支援的值為 0,表示應讓系統大聲朗讀通知。

status String

必填。

作業結果。

支援的值:

FAILURE
errorCode String

必填。

這個值可以是此特性的任何錯誤代碼,例如 deviceStuck

範例

裝置已停止執行。

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

完成目前的週期時發生錯誤。

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

裝置錯誤

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