智慧型住宅物件偵測特徵結構定義
action.devices.traits.ObjectDetection
- 這個特性屬於裝置可以偵測物件或人物,並傳送通知給使用者。根據預設,在門鈴鈴聲響起後,智慧螢幕和揚聲器會透過 Google 助理宣布所有 ObjectDetection 通知。
裝置屬性
無。
裝置狀態
無。
裝置指令
無。
裝置通知
具備此特性的裝置可能會隨著裝置狀態變更,傳回下列通知酬載。如要進一步瞭解如何實作通知,請參閱「智慧型住宅動作的通知」一文。
欄位 | 類型 | 說明 |
---|---|---|
ObjectDetection |
物件 |
必要。 通知酬載。 |
priority |
整數 |
必要。 代表通知層級。目前支援的值為 0,表示系統應朗讀通知內容。 |
detectionTimestamp |
整數 |
必要。 偵測到物件的週期時間戳記 (以毫秒為單位)。 |
objects |
物件 |
必要。 依類別偵測到的物件集合。 |
named |
陣列 |
使用者利用標籤標記出的物件清單。 |
[item, ...] |
String |
物件標籤。 至少要有 1 個項目。 |
familiar |
整數 |
使用者沒有標籤所辨識出的物件數量。 |
unfamiliar |
整數 |
裝置無法辨識的使用者物件數量。 |
unclassified |
整數 |
偵測到裝置無法分類的物件數量。 |
範例
2000 年 1 月 1 日偵測到兩個不明物件。
{ "ObjectDetection": { "objects": { "unclassified": 2 }, "priority": 0, "detectionTimestamp": 946684800000 } }
在 2000 年 1 月 1 日偵測到你認識的人。
{ "ObjectDetection": { "objects": { "familiar": 1 }, "priority": 0, "detectionTimestamp": 946684800000 } }
系統偵測到 2000 年 1 月 1 日。
{ "ObjectDetection": { "objects": { "named": [ "Alice" ] }, "priority": 0, "detectionTimestamp": 946684800000 } }