表示

Google Nest Hub Max

Google Nest Hub Max ディスプレイ Smart Device Management（SDM）API でサポートされています。このデバイスはデバイスタイプを返します （ディスプレイ）:

sdm.devices.types.DISPLAY

Google Nest Hub Max にはカメラが搭載されており、 デバイスタイプとして CAMERA を指定します。

トレイト

リファレンス

このデバイスに関連するトレイト、コマンド、イベントは次のとおりです。

トレイト説明コマンドイベント
CameraEventImageこのトレイトは、イベントからの画像の生成をサポートするデバイスに使用します。GenerateImage
CameraImageこのトレイトは、画像撮影をサポートするデバイスに使用します。
CameraLiveStreamこのトレイトは、ライブ配信をサポートするデバイスに使用します。GenerateRtspStream
ExtendRtspStream
StopRtspStream
CameraMotionこのトレイトは、モーション検知イベントをサポートするデバイスに使用します。モーション
CameraPersonこのトレイトは、人感センサーイベントをサポートするデバイスに使用します。人物
CameraSoundこのトレイトは、サウンド検知イベントをサポートするデバイスに使用します。サウンド
情報このトレイトはどのデバイスにも属し、デバイス関連の情報に使用します。

JSON

GET レスポンスにトレイトが存在しない場合、そのトレイトまたは この機能は現在デバイスでは利用できません。詳しくは、 デバイスの種類: 詳細 情報です。

{
  "type" : "sdm.devices.types.DISPLAY",
  "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.Info" : {
      "customName" : "My device"
    }
  }
}

カメラ アクティビティを処理する

DISPLAY デバイスタイプからトリガーできるイベントは次のとおりです。

タイプ 要素 説明
イベント CameraMotion トレイトのモーション イベント カメラで動きが検知されました。
イベント CameraPerson トレイトの Person イベント カメラで人物が検出されました。
イベント CameraSound トレイトのサウンド イベント カメラで音が検知されました。
たとえば、以下の例ではカメラが動きを検出しています。

ペイロード

{
  "eventId" : "6d12911e-0181-495c-97b5-b6e8884c50ae",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "FJ-QMyhCTKninhnimPOwVDjELx...",
      }
    }
  }
  "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" : "1GfoI8sZUnc79jrq7YfVodeqtf..."
  }
}

レスポンス

{
  "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 エラーコードの完全なリスト。