智慧型住宅物件偵測特徵結構定義
action.devices.traits.ObjectDetection
:這項特性屬於可以偵測物體或人員,並向使用者傳送通知的裝置。根據預設,只要門鈴發出鈴聲後,即可透過 Google 助理在智慧螢幕和揚聲器上朗讀所有 ObjectDetection 通知。
裝置屬性
無。
裝置狀態
無。
裝置指令
無。
裝置通知
具有這個特性的裝置可能會在裝置狀態變更時傳回下列通知酬載。如要進一步瞭解如何實作通知,請參閱「智慧住宅動作通知」。
欄位 | 類型 | 說明 |
---|---|---|
ObjectDetection |
物件 |
必要。 通知酬載。 |
priority |
整數 |
必要。 代表通知層級。目前支援的值為 0,表示系統應朗讀通知。 |
detectionTimestamp |
整數 |
必要。 偵測到物件的 Epoch 紀元時間戳記,以毫秒為單位。 |
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 } }
Alice 偵測到於 2000 年 1 月 1 日。
{ "ObjectDetection": { "objects": { "named": [ "Alice" ] }, "priority": 0, "detectionTimestamp": 946684800000 } }