智慧型住宅 ObjectDetection 特徵架構

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

裝置錯誤

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