智慧型住宅狀態報告特性結構定義
action.devices.traits.StatusReport - 這個特徵會回報特定裝置或已連結一組裝置的目前狀態，
特定裝置可以回報群組目前的狀態，以及群組中任何相關裝置的狀態。舉例來說，目標裝置可能是安全性系統，而相關裝置代表個別感應器。StatusReport 是匯總的回報收集狀態，但不會取代個別位址。凡是可透過 Google 助理存取的裝置，都必須在 SYNC 回應中回報為獨立的裝置。
裝置屬性
無。
裝置狀態：STATE
具有此特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱意圖執行要求一文。
| 州 | 類型 | 說明 |
|---|---|---|
currentStatusReport |
陣列 |
必填。 裝置目前的錯誤或例外狀況狀態，以及任何相關裝置 ID。 |
[item, ...] |
物件 |
目前狀態。 |
blocking |
布林 |
如果錯誤或目前狀態會封鎖後續指令，傳回 True。 |
deviceTarget |
字串 |
目標裝置的 ID。 |
priority |
整數 |
指定此狀態的優先順序。值越低，優先順序就越高，優先順序最高為 0。Google 會將錯誤或例外狀態回報給最高優先順序。視實際情況而定，Google 只能回報高優先順序的錯誤或例外情況。 |
statusCode |
字串 |
裝置的目前狀態。請參閱錯誤和例外狀況的完整清單。 |
範例
我的安全系統還安全嗎？
{
"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"
}
]
}
裝置指令
無。