以前の Google Nest Doorbell はすべて、Smart Device Management(SDM)API でサポートされています。 このデバイスは DOORBELL のデバイスタイプを返します。
sdm.devices.types.DOORBELL
Google Nest Doorbell(従来版)にはカメラが搭載されています。カメラは デバイスタイプとして CAMERA を指定します。
トレイト
リファレンス
このデバイスに関連するトレイト、コマンド、イベントは次のとおりです。
トレイト | 説明 | コマンド | イベント |
---|---|---|---|
CameraEventImage | このトレイトは、イベントからの画像の生成をサポートするデバイスに使用します。 | GenerateImage | |
CameraImage | このトレイトは、画像撮影をサポートするデバイスに使用します。 | ||
CameraLiveStream | このトレイトは、ライブ配信をサポートするデバイスに使用します。 | GenerateRtspStream ExtendRtspStream StopRtspStream | |
CameraMotion | このトレイトは、モーション検知イベントをサポートするデバイスに使用します。 | モーション | |
CameraPerson | このトレイトは、人感センサーイベントをサポートするデバイスに使用します。 | 人物 | |
CameraSound | このトレイトは、サウンド検知イベントをサポートするデバイスに使用します。 | サウンド | |
DoorbellChime | このトレイトは、ドアホンのチャイムや関連する押下イベントをサポートするデバイスに使用します。 | チャイム | |
情報 | このトレイトはどのデバイスにも属し、デバイス関連の情報に使用します。 |
JSON
GET レスポンスにトレイトが存在しない場合、そのトレイトまたは この機能は現在デバイスでは利用できません。詳しくは、 デバイスの種類: 詳細 情報です。
{ "type" : "sdm.devices.types.DOORBELL", "traits" : { "sdm.devices.traits.CameraEventImage" : {}, "sdm.devices.traits.CameraImage" : { "maxImageResolution" : { "width" : 1280, "height" : 960 } }, "sdm.devices.traits.CameraLiveStream" : { "maxVideoResolution" : { "width" : 640, "height" : 480 }, "videoCodecs" : ["H264"], "audioCodecs" : ["AAC"], "supportedProtocols" : ["WEB_RTC"] }, "sdm.devices.traits.CameraMotion" : {}, "sdm.devices.traits.CameraPerson" : {}, "sdm.devices.traits.CameraSound" : {}, "sdm.devices.traits.DoorbellChime" : {}, "sdm.devices.traits.Info" : { "customName" : "My device" } } }
ドアホンとカメラのアクティビティを処理する
以下のイベントは DOORBELL デバイスタイプからトリガーされる可能性があります。 :タイプ | 要素 | 説明 |
---|---|---|
イベント | CameraMotion トレイトのモーション イベント | カメラで動きが検知されました。 |
イベント | CameraPerson トレイトの Person イベント | カメラで人物が検出されました。 |
イベント | CameraSound トレイトのサウンド イベント | カメラで音が検知されました。 |
イベント | DoorbellChime トレイトのチャイム イベント | ドアホンが押されました。 |
ペイロード
{ "eventId" : "8cfbc540-68c8-42dd-9bb1-5b71c6ac7fa3",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "j1L8rc2B4PesaHP2zcdW6A-AwG..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
eventId
が含まれていて、
GenerateImage
使用できます。このコマンドは、関連するカメラ画像のダウンロード URL を返します。
event:
リクエスト
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "HMy5lGCGEPspcfxKvpmxoiqf2i..."
}
}
レスポンス
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
カメラ画像をダウンロードする
url
への GET 呼び出しを
GenerateImage コマンド レスポンス
HTTP Authorization ヘッダーで token
を Basic 認証で使用します。
カメラ画像をダウンロードします。
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...
width
または height
クエリ パラメータを使用して、
ダウンロードされます。これらのパラメータのいずれか 1 つのみを指定する必要があります。もう 1 つは、
パラメータは、カメラのアスペクト比に応じて自動的にスケーリングされます。
たとえば、カメラのアスペクト比が 4:3 の場合、カメラ画像をダウンロードするには、 解像度が 480 x 360 の場合は、幅または高さを指定します。
幅
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480
高さ
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360
ダウンロード URL にはその他の制限が適用されます。
- URL で両方のパラメータを指定すると、
width
が使用され、height
は無視されます。 - URL にどちらのパラメータも指定されていない場合、
width
。
CameraImage トレイト: 説明します。
ライブ ストリームにアクセスする
カメラのライブ ストリームにアクセスできる。次のストリーム形式が このデバイスのサポート:
- RTSP
カメラとサポートされているストリーミング形式の一覧については、以下をご覧ください。 サポートされているデバイス。
ライブ ストリームにアクセスするには、適切な [ストリームを生成]Format コマンドを CameraLiveStream あります。
RTSP
RTSP ストリームの場合、
CameraLiveStream トレイト コマンドの GenerateRtspStream コマンド
ストリーム URL と関連する streamToken
を返します。
リクエスト
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream
",
"params" : {}
}
レスポンス
{ "results" : { "streamUrls" : { "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken" }, "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "streamToken" : "g.0.streamingToken", "expiresAt" : "2018-01-04T18:30:00.000Z" } }
次に、ストリーム URL を使用してカメラのライブ ストリームにアクセスします。
rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken
RTSP ライブ ストリーム URL はクライアント間で共有できません。ストリーム URL を使用できるのは、一度に 1 つのクライアントのみです。複数のクライアントが同時に同じカメラからストリーミングする場合は、クライアントごとに RTSP コマンドを送信し、各クライアントで独自のストリーム URL を使用する必要があります。
ライブ ストリームを延長する
カメラのライブ ストリーム セッションの有効期間は 5 分間です。ライブ配信の有効期間を延長する必要がある場合は、生成したストリーム形式に適した CameraLiveStream トレイトの適切なFormatストリーム延長コマンドを使用します。
RTSP
RTSP ストリームを拡張するには、
CameraLiveStream トレイト コマンドの ExtendRtspStream コマンドを使用すると、
新しい streamExtensionToken
と streamToken
を入手
values:
リクエスト
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream
",
"params" : {
"streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
}
}
レスポンス
{ "results" : { "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "streamToken" : "g.0.newStreamingToken", "expiresAt" : "2018-01-04T18:30:00.000Z" } }
引き続き表示するには、これらの新しい値でストリーム URL を更新してください ライブ ストリーム:
rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken
ライブ ストリームを停止する
カメラのライブ ストリームを使用しなくなった場合は、ライブ ストリームを停止し、 ストリームは無効になりますこれを行うには、適切な停止Formatストリームを使用します。 コマンドを CameraLiveStream 生成したストリーム形式のトレイトを指定します。
RTSP
RTSP ストリームを停止するには、トークンを使用して CameraLiveStream トレイト コマンドの StopRtspStream コマンド:
リクエスト
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream
",
"params" : {
"streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
}
}
レスポンス
{}
エラー
このデバイスに関連して、以下のエラーコードが返される可能性があります。
エラー メッセージ | RPC | トラブルシューティング |
---|---|---|
カメラ画像はダウンロードできなくなりました。 | DEADLINE_EXCEEDED |
イベント画像は、イベントの公開から 30 秒後に期限切れになります。有効期限が切れる前に、画像をダウンロードしてください。 |
アクティビティ ID はカメラのものではありません。 | FAILED_PRECONDITION |
カメラ イベントから返された正しい eventID を使用します。 |
詳しくは、API エラーコード リファレンスをご覧ください。 API エラーコードの完全なリスト。