ドアホン(従来)

Nest Hello

以前の 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 コマンドを使用すると、 新しい streamExtensionTokenstreamToken を入手 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 エラーコードの完全なリスト。