スマートホーム ObjectDetection トレイト スキーマ

action.devices.traits.ObjectDetection - このトレイトは、物体や人を検出してユーザーに通知できるデバイスに使用します。デフォルトでは、オブジェクト検出はすべて、ドアホンのチャイムが鳴ると、Google アシスタント搭載のスマートディスプレイとスマート スピーカーで通知されます。

デバイスの属性

なし

デバイスのステータス

なし。

デバイスのコマンド

なし

デバイスの通知

この特性を持つデバイスは、デバイスの状態変化の一部として、次の通知ペイロードを返すことがあります。通知の実装について詳しくは、スマートホーム アクションの通知をご覧ください。

フィールド	タイプ	説明
ObjectDetection	オブジェクト	必須。 通知ペイロード:
priority	Integer	必須。 通知レベルを表します。現在サポートされている値は 0 で、これは通知が読み上げられることを示します。
detectionTimestamp	Integer	必須。 オブジェクトが検出されたエポック タイムスタンプ（ミリ秒単位）。
objects	オブジェクト	必須。 カテゴリ別に検出されたオブジェクトのコレクション。
named	配列	ユーザーが認識した、ラベルのタグが付けられたオブジェクトのリスト。
[item, ...]	文字列	オブジェクト ラベル。 少なくとも 1 つのアイテムが必要です。
familiar	Integer	ユーザーが認識し、ラベルがないオブジェクトの数。
unfamiliar	Integer	ユーザーが認識できないデバイスによって検出されたオブジェクトの数。
unclassified	Integer	デバイスが分類できなかったと検出されたオブジェクトの数。

例

2000 年 1 月 1 日に 2 つの不明なオブジェクトを検出した。

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

デバイスエラー

エラーと例外のリストをご覧ください。