智慧型住宅狀態報告特徵結構定義
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" } ] }
裝置指令
無。