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

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

裝置錯誤

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