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

action.devices.traits.StatusReport - 這項特徵會回報特定裝置或已連線裝置群組的目前狀態。

特定裝置可以回報目前的狀態，以及群組中任何相關裝置的狀態。舉例來說，目標裝置可以是安全防護系統，相關裝置則代表個別感應器。StatusReport 可做為匯總，用於回報集體狀態，但不會取代個別地址。凡是 Google 助理可存取的裝置，都應在 SYNC 回應中回報為個別裝置。

裝置屬性

無。

裝置狀態

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

州	類型	說明
currentStatusReport	陣列	必要。 裝置和任何相關裝置 ID 目前的錯誤或例外狀況狀態。
[item, ...]	物件	目前狀態。
blocking	布林值	如果錯誤或目前狀態會阻礙後續指令執行，則為 True。
deviceTarget	String	目標裝置的 ID。
priority	整數	指定這個狀態的優先順序。值越小，優先順序越高，最高優先順序為 0。Google 會依優先順序由高至低回報錯誤或例外狀況狀態。視介面而定，Google 可能只會回報高優先順序的錯誤或例外狀況。 最小值：0。
statusCode	String	裝置目前的狀態。請參閱「錯誤和例外狀況」的完整清單。

範例

保全系統運作正常嗎？

{
  "currentStatusReport": [
    {
      "blocking": false,
      "deviceTarget": "alarm_1",
      "priority": 0,
      "statusCode": "lowBattery"
    },
    {
      "blocking": false,
      "deviceTarget": "front_window_1",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": false,
      "deviceTarget": "back_window_2",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": true,
      "deviceTarget": "alarm_2",
      "priority": 0,
      "statusCode": "needsSoftwareUpdate"
    }
  ]
}

裝置指令

無。

裝置錯誤

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