DoorbellChime スキーマ
Google Nest Doorbell(従来版)
sdm.devices.traits.DoorbellChime
このトレイトは、ドアホンのチャイムや関連する押下イベントをサポートするデバイスに使用します。
フィールド
このトレイトで使用できるフィールドはありません。
コマンド
このトレイトで使用できるコマンドはありません。
イベント
チャイム
更新可能ドアホンが押されました。
この予定では更新可能な通知がサポートされています。このイベントから作成された既存のアプリ通知は、同じ eventThreadId
の後続のイベントのコンテンツを使用して更新できます。
チャイム イベント
ペイロード
{ "eventId" : "582b5ef1-72d9-490f-96a4-e6fd80bc5e1f",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "FPXXRESk-_p8ITUubdhSS9mhc3..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
チャイム イベント フィールド
フィールド | 説明 | データ型 |
---|---|---|
eventSessionId |
Google Nest Doorbell(Battery Type) これを使用して、このイベントを CameraClipPreview トレイトの関連する ClipPreview イベントに関連付けます。 |
string 例: 「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」 |
eventId |
Google Nest Doorbell(従来版) GenerateImage コマンドとともに使用して、このイベントに関連するカメラ画像をダウンロードします。 |
string 例: 「FPXXRESk-_p8ITUubdhSS9mhc3...」 |
イベント ペイロードのフィールド
フィールド | 説明 | データ型 |
---|---|---|
eventId |
イベントの一意の識別子。 | string 例: 「582b5ef1-72d9-490f-96a4-e6fd80bc5e1f」 |
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 エラーコードの完全なリスト。