智慧型住宅 ObjectDetection 特徵架構
action.devices.traits.ObjectDetection：這個特徵屬於可偵測物體或人員，並傳送通知給使用者的裝置。根據預設，門鈴響鈴後，所有 ObjectDetection 通知都會在支援 Google 助理的智慧螢幕和音箱上播報。
裝置屬性
無。
裝置狀態
無。
裝置指令
無。
裝置通知
具備此特徵的裝置可能會在裝置狀態變更時傳回下列通知酬載。如要進一步瞭解如何導入通知，請參閱「智慧住宅動作的通知」。
| 欄位 | 類型 | 說明 |
|---|---|---|
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
}
}在 2000 年 1 月 1 日偵測到 Alice。
{
"ObjectDetection": {
"objects": {
"named": [
"Alice"
]
},
"priority": 0,
"detectionTimestamp": 946684800000
}
}