智慧型住宅物件偵測特徵結構定義

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
  }
}

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。