Smart Home StatusReport 特徵結構定義
action.devices.traits.StatusReport
:這個特性會回報特定裝置或已連結一組裝置的目前狀態。
特定裝置可以回報裝置目前的狀態,以及群組中任何相關裝置的狀態。舉例來說,目標裝置可能是安全系統,且裝置中含有代表個別感應器的相關裝置。StatusReport 可做為回報集合狀態的匯總,但不會取代個別位址。凡是可透過 Google 助理存取的裝置,都應在 SYNC
回應中回報為獨立裝置。
裝置屬性
無。
裝置狀態
具有這個特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱「意圖執行要求」。
狀態 | 類型 | 說明 |
---|---|---|
currentStatusReport |
陣列 |
必要。 裝置和任何相關裝置 ID 的目前錯誤或例外狀況狀態。 |
[item, ...] |
物件 |
目前狀態。 |
blocking |
布林 |
如果錯誤或目前狀態阻礙後續的指令執行作業,則為 True。 |
deviceTarget |
String |
目標裝置的 ID。 |
priority |
整數 |
指定這個狀態的優先等級。值越小,優先順序越高,優先順序則是 0。Google 會以最高到最低的優先順序回報錯誤或例外狀況狀態。視途徑而定,Google 可能只會回報優先順序較高的錯誤或例外狀況。 |
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" } ] }
裝置指令
無。