DoorbellChime スキーマ

Google Nest Doorbell(従来版) Google Nest Doorbell(バッテリー式) Google Nest Doorbell(電源直結型) 

sdm.devices.traits.DoorbellChime

このトレイトは、ドアホンのチャイムと関連する押下イベントをサポートするデバイスに使用します。

フィールド

この特性に使用できるフィールドはありません。

コマンド

この特性で使用できるコマンドはありません。

イベント

チャイム

更新可能 

ドアホンが押された。

このイベントは、更新可能な通知をサポートしています。このイベントから作成された既存のアプリ通知は、同じ eventThreadId を持つ後続のイベントのコンテンツを使用して更新できます。

チャイム イベント

ペイロード

{
  "eventId" : "40c955ec-f512-437a-ba81-4ca8dca5ad88",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "cRrrfG7XSfh8Wn1Kj4ocaNGKZM..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

Chime イベント フィールド

フィールド 説明 データ型
eventSessionId Google Nest Doorbell(内蔵バッテリー・電源直結併用型) Google Nest Doorbell(電源直結型) 関連するアクティビティの単一セッションの一部として発生したアクティビティに割り当てられる ID。イベントの統合に使用される場合があります。

これを使用して、このイベントを CameraClipPreview トレイトの関連する ClipPreview イベントに関連付けます。

string
例: 「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
eventId Google Nest Doorbell(従来版) イベントに関連付けられた ID。

GenerateImage コマンドとともに使用して、このイベントに関連するカメラ画像をダウンロードします。

string
例: 「cRrrfG7XSfh8Wn1Kj4ocaNGKZM...」

イベント ペイロード フィールド

フィールド 説明 データ型
eventId イベントの一意の識別子。 string
例: "40c955ec-f512-437a-ba81-4ca8dca5ad88"
timestamp イベントの発生時間。 string
例: "2019-01-01T00:00:01Z"
resourceUpdate リソースの更新に関する詳細情報を示すオブジェクト。 object
userId ユーザーを表す一意の難読化された識別子。 string
例: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId 更新可能 イベント スレッドの一意の識別子。 string
例: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState 更新可能 イベント スレッドの状態。 string
値:「STARTED」、「UPDATED」、「ENDED」
resourceGroup このイベントに類似した更新が存在する可能性があるリソースを示すオブジェクト。イベント自体のリソース(resourceUpdate オブジェクトから)は、常にこのオブジェクトに存在します。 object

イベントの種類と動作の詳細については、イベントをご覧ください。

エラー

この特性に関連して、次のエラーコードが返されることがあります。

エラー メッセージ RPC トラブルシューティング
カメラ画像をダウンロードできなくなりました。 DEADLINE_EXCEEDED イベント画像は、イベントの公開から 30 秒後に期限切れになります。有効期限が切れる前に画像をダウンロードしてください。
イベント ID がカメラに属していない。 FAILED_PRECONDITION カメラ イベントから返された正しい eventID を使用します。

API エラーコードの一覧については、API エラーコードのリファレンスをご覧ください。