Esquema da CameraLiveStream

Nest Cam (legada) Nest Cam (interna ou externa, com bateria) Nest Cam com holofote Nest Cam Doorbell2 Max0 (com fio, com fio) Doorbell{/1 Max1 Max1 Max1 Max1

sdm.devices.traits.CameraLiveStream

Essa característica pertence a qualquer dispositivo compatível com a transmissão ao vivo.

Campos

Field Descrição Tipo de dados
maxVideoResolution Resolução máxima da transmissão de vídeo ao vivo. VideoResolution
videoCodecs Codecs de vídeo compatíveis com a transmissão ao vivo. array(string)
Valor: ["H264"]
audioCodecs Codecs de áudio compatíveis com a transmissão ao vivo. array(string)
Valor: ["AAC"]
supportedProtocols Protocolos de streaming compatíveis com o dispositivo. O valor deste campo indica quais comandos são compatíveis com o dispositivo. Por exemplo, se este campo contiver WEB_RTC, apenas os comandos WEB_RTC serão suportados. array(string)
Valor: ["RTSP", "WEB_RTC"]

Resolução de vídeo (maxVideoResolution)

Field Descrição Tipo de dados
width Largura máxima da resolução da imagem. Também pode ser usado como um parâmetro de consulta no URL de download. int32
Exemplo: 640
height Altura máxima da resolução da imagem. Também pode ser usado como um parâmetro de consulta no URL de download. int32
Exemplo: 480

Exemplo de solicitação e resposta GET

Solicitação

GET /enterprises/project-id/devices/device-id

Resposta

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.CameraLiveStream" : {
      "maxVideoResolution" : {
        "width" : 640,
        "height" : 480
      },
      "videoCodecs" : ["H264"],
      "audioCodecs" : ["AAC"],
      "supportedProtocols" : ["WEB_RTC"]
    }
  }
}

Comandos

GenerateRtspStream

Nest Cam (legada) Nest Hub Max Nest Doorbell (legado) 

Solicite um token para acessar um URL de transmissão ao vivo do RTSP.

Os URLs de transmissão ao vivo do RTSP não podem ser compartilhados entre clientes. Um URL de stream só pode ser usado por um cliente de cada vez. Se vários clientes quiserem transmitir da mesma câmera ao mesmo tempo, os comandos RTSP devem ser enviados para cada cliente individual e cada cliente deve usar o próprio URL de stream.

Solicitação e resposta GenerateRtspStream

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream",
  "params" : {}
}

Resposta

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Campos de resposta GenerateRtspStream

Field Descrição Tipo de dados
streamUrls Mapa dos URLs de transmissão ao vivo do RTSP. object
streamExtensionToken Token a ser usado para estender o streamToken para uma transmissão ao vivo do RTSP. string
Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
streamToken Token a ser usado para acessar uma transmissão ao vivo do RTSP. string
Exemplo: "g.0.streamingToken"
expiresAt Hora em que streamExtensionToken e streamToken expiram, no formato RFC 3339. string
Exemplo: "2018-01-04T18:30:00.000Z"

ExtendRtspStream

Nest Cam (legada) Nest Hub Max Nest Doorbell (legado) 

Solicite um novo token de acesso ao URL de transmissão ao vivo do RTSP para substituir um token de acesso do RTSP válido antes que ele expire. Isso também é usado para substituir um token RTSP válido de uma solicitação de comando ExtendRtspStream anterior.

As sessões de transmissão ao vivo da câmera só são válidas por 5 minutos. Se você precisar estender o ciclo de vida de uma transmissão ao vivo, use o comando "Estender"Format"Estender" da característica CameraLiveStream do formato de transmissão que você gerou.

Solicitação e resposta ExtendRtspStream

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

Resposta

{
  "results" : {
    "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "streamToken" : "g.0.newStreamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Campos de solicitação ExtendRtspStream

Field Descrição Tipo de dados
streamExtensionToken Token a ser usado para solicitar uma extensão para o token de streaming do RTSP. string
Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."

Campos de resposta de ExtendRtspStream

Field Descrição Tipo de dados
streamExtensionToken Token a ser usado para visualizar uma transmissão ao vivo do RTSP existente e para solicitar uma extensão para o token de streaming. string
Exemplo: "dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
streamToken Novo token a ser usado para acessar uma transmissão ao vivo do RTSP existente. string
Exemplo: "g.0.newStreamingToken"
expiresAt Hora em que streamExtensionToken e streamToken expiram, no formato RFC 3339. string
Exemplo: "2018-01-04T18:30:00.000Z"

StopRtspStream

Nest Cam (legada) Nest Hub Max Nest Doorbell (legado) 

Invalida um token de acesso válido do RTSP e interrompe a transmissão ao vivo do RTSP vinculado a esse token de acesso.

Solicitação e resposta de StopRtspStream

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

Resposta

{}

Campos de solicitação de StopRtspStream

Field Descrição Tipo de dados
streamExtensionToken Token a ser usado para invalidar uma transmissão ao vivo do RTSP existente. string
Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."

GenerateWebRtcStream

Nest Cam (legado) Nest Cam (interna ou externa, com bateria) Nest Cam com holofote Nest Cam (interna, com fio) Nest Doorbell (com bateria) Nest Doorbell (com fio)

Gerar uma transmissão ao vivo WebRTC para um dispositivo.

Solicitação e resposta GenerateWebRtcStream

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.GenerateWebRtcStream",
  "params" : {
    "offerSdp" : "offerSdp"
  }
}

Resposta

{
  "results" : {
    "answerSdp" : "answerSdp",
    "expiresAt" : "2020-01-04T18:30:00.000Z",
    "mediaSessionId" : "-xglvYd3yxgIalLTq9gldicmPK..."
  }
}

Campos de solicitação GenerateWebRtcStream

Recomendamos usar o exemplo de aplicativo da Web para saber como gerar uma transmissão ao vivo de sucesso. Essa amostra gera um offerSdp válido que atende a todas as restrições de oferta SDP para câmeras Nest.

Uma oferta SDP para câmeras Nest precisa atender às seguintes restrições:

  • Somente o formato unificado é compatível. O Plano B não é aceito.
  • Todas as linhas de mídia (m=) precisam estar na oferta e estar nesta ordem:
    1. áudio
    2. Vídeo
    3. aplicativo
  • O Trickle ICE é compatível, mas não é obrigatório.
  • Somente o codec Opus é compatível com áudio.
  • A configuração de áudio precisa ser definida como a=recvonly (somente recebimento).
  • A oferta precisa terminar com um caractere de nova linha de \r\n ou \n.

Veja um exemplo de oferta válida

Sem formatação:

v=0\r\no=- 2214114893783582286 2 IN IP4 127.0.0.1\r\ns=-\r\nt=0 0\r\na=group:BUNDLE 0 1 2\r\na=extmap-allow-mixed\r\na=msid-semantic: WMS\r\nm=audio 9 UDP/TLS/RTP/SAVPF 111 63 103 104 9 0 8 106 105 13 110 112 113 126\r\nc=IN IP4 0.0.0.0\r\na=rtcp:9 IN IP4 0.0.0.0\r\na=ice-ufrag:6ReD\r\na=ice-pwd:QBmcZYd/t+InpMVkxQEEXnE4\r\na=ice-options:trickle\r\na=fingerprint:sha-256 DD:7E:6F:CD:B8:13:4E:37:D2:92:6D:8E:30:FB:FE:13:29:C9:F8:FD:78:0B:C4:59:42:61:BC:CF:02:91:6B:3C\r\na=setup:actpass\r\na=mid:0\r\na=extmap:1 urn:ietf:params:rtp-hdrext:ssrc-audio-level\r\na=extmap:2 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time\r\na=extmap:3 http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01\r\na=extmap:4 urn:ietf:params:rtp-hdrext:sdes:mid\r\na=recvonly\r\na=rtcp-mux\r\na=rtpmap:111 opus/48000/2\r\na=rtcp-fb:111 transport-cc\r\na=fmtp:111 minptime=10;useinbandfec=1\r\na=rtpmap:63 red/48000/2\r\na=fmtp:63 111/111\r\na=rtpmap:103 ISAC/16000\r\na=rtpmap:104 ISAC/32000\r\na=rtpmap:9 G722/8000\r\na=rtpmap:0 PCMU/8000\r\na=rtpmap:8 PCMA/8000\r\na=rtpmap:106 CN/32000\r\na=rtpmap:105 CN/16000\r\na=rtpmap:13 CN/8000\r\na=rtpmap:110 telephone-event/48000\r\na=rtpmap:112 telephone-event/32000\r\na=rtpmap:113 telephone-event/16000\r\na=rtpmap:126 telephone-event/8000\r\nm=video 9 UDP/TLS/RTP/SAVPF 96 97 98 99 100 101 122 102 121 127 120 125 107 108 109 35 36 124 119 123 118 114 115 116 37\r\nc=IN IP4 0.0.0.0\r\na=rtcp:9 IN IP4 0.0.0.0\r\na=ice-ufrag:6ReD\r\na=ice-pwd:QBmcZYd/t+InpMVkxQEEXnE4\r\na=ice-options:trickle\r\na=fingerprint:sha-256 DD:7E:6F:CD:B8:13:4E:37:D2:92:6D:8E:30:FB:FE:13:29:C9:F8:FD:78:0B:C4:59:42:61:BC:CF:02:91:6B:3C\r\na=setup:actpass\r\na=mid:1\r\na=extmap:14 urn:ietf:params:rtp-hdrext:toffset\r\na=extmap:2 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time\r\na=extmap:13 urn:3gpp:video-orientation\r\na=extmap:3 http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01\r\na=extmap:5 http://www.webrtc.org/experiments/rtp-hdrext/playout-delay\r\na=extmap:6 http://www.webrtc.org/experiments/rtp-hdrext/video-content-type\r\na=extmap:7 http://www.webrtc.org/experiments/rtp-hdrext/video-timing\r\na=extmap:8 http://www.webrtc.org/experiments/rtp-hdrext/color-space\r\na=extmap:4 urn:ietf:params:rtp-hdrext:sdes:mid\r\na=extmap:10 urn:ietf:params:rtp-hdrext:sdes:rtp-stream-id\r\na=extmap:11 urn:ietf:params:rtp-hdrext:sdes:repaired-rtp-stream-id\r\na=recvonly\r\na=rtcp-mux\r\na=rtcp-rsize\r\na=rtpmap:96 VP8/90000\r\na=rtcp-fb:96 goog-remb\r\na=rtcp-fb:96 transport-cc\r\na=rtcp-fb:96 ccm fir\r\na=rtcp-fb:96 nack\r\na=rtcp-fb:96 nack pli\r\na=rtpmap:97 rtx/90000\r\na=fmtp:97 apt=96\r\na=rtpmap:98 VP9/90000\r\na=rtcp-fb:98 goog-remb\r\na=rtcp-fb:98 transport-cc\r\na=rtcp-fb:98 ccm fir\r\na=rtcp-fb:98 nack\r\na=rtcp-fb:98 nack pli\r\na=fmtp:98 profile-id=0\r\na=rtpmap:99 rtx/90000\r\na=fmtp:99 apt=98\r\na=rtpmap:100 VP9/90000\r\na=rtcp-fb:100 goog-remb\r\na=rtcp-fb:100 transport-cc\r\na=rtcp-fb:100 ccm fir\r\na=rtcp-fb:100 nack\r\na=rtcp-fb:100 nack pli\r\na=fmtp:100 profile-id=2\r\na=rtpmap:101 rtx/90000\r\na=fmtp:101 apt=100\r\na=rtpmap:122 VP9/90000\r\na=rtcp-fb:122 goog-remb\r\na=rtcp-fb:122 transport-cc\r\na=rtcp-fb:122 ccm fir\r\na=rtcp-fb:122 nack\r\na=rtcp-fb:122 nack pli\r\na=fmtp:122 profile-id=1\r\na=rtpmap:102 H264/90000\r\na=rtcp-fb:102 goog-remb\r\na=rtcp-fb:102 transport-cc\r\na=rtcp-fb:102 ccm fir\r\na=rtcp-fb:102 nack\r\na=rtcp-fb:102 nack pli\r\na=fmtp:102 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=42001f\r\na=rtpmap:121 rtx/90000\r\na=fmtp:121 apt=102\r\na=rtpmap:127 H264/90000\r\na=rtcp-fb:127 goog-remb\r\na=rtcp-fb:127 transport-cc\r\na=rtcp-fb:127 ccm fir\r\na=rtcp-fb:127 nack\r\na=rtcp-fb:127 nack pli\r\na=fmtp:127 level-asymmetry-allowed=1;packetization-mode=0;profile-level-id=42001f\r\na=rtpmap:120 rtx/90000\r\na=fmtp:120 apt=127\r\na=rtpmap:125 H264/90000\r\na=rtcp-fb:125 goog-remb\r\na=rtcp-fb:125 transport-cc\r\na=rtcp-fb:125 ccm fir\r\na=rtcp-fb:125 nack\r\na=rtcp-fb:125 nack pli\r\na=fmtp:125 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=42e01f\r\na=rtpmap:107 rtx/90000\r\na=fmtp:107 apt=125\r\na=rtpmap:108 H264/90000\r\na=rtcp-fb:108 goog-remb\r\na=rtcp-fb:108 transport-cc\r\na=rtcp-fb:108 ccm fir\r\na=rtcp-fb:108 nack\r\na=rtcp-fb:108 nack pli\r\na=fmtp:108 level-asymmetry-allowed=1;packetization-mode=0;profile-level-id=42e01f\r\na=rtpmap:109 rtx/90000\r\na=fmtp:109 apt=108\r\na=rtpmap:35 AV1/90000\r\na=rtcp-fb:35 goog-remb\r\na=rtcp-fb:35 transport-cc\r\na=rtcp-fb:35 ccm fir\r\na=rtcp-fb:35 nack\r\na=rtcp-fb:35 nack pli\r\na=rtpmap:36 rtx/90000\r\na=fmtp:36 apt=35\r\na=rtpmap:124 H264/90000\r\na=rtcp-fb:124 goog-remb\r\na=rtcp-fb:124 transport-cc\r\na=rtcp-fb:124 ccm fir\r\na=rtcp-fb:124 nack\r\na=rtcp-fb:124 nack pli\r\na=fmtp:124 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=4d0032\r\na=rtpmap:119 rtx/90000\r\na=fmtp:119 apt=124\r\na=rtpmap:123 H264/90000\r\na=rtcp-fb:123 goog-remb\r\na=rtcp-fb:123 transport-cc\r\na=rtcp-fb:123 ccm fir\r\na=rtcp-fb:123 nack\r\na=rtcp-fb:123 nack pli\r\na=fmtp:123 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=640032\r\na=rtpmap:118 rtx/90000\r\na=fmtp:118 apt=123\r\na=rtpmap:114 red/90000\r\na=rtpmap:115 rtx/90000\r\na=fmtp:115 apt=114\r\na=rtpmap:116 ulpfec/90000\r\na=rtpmap:37 flexfec-03/90000\r\na=rtcp-fb:37 goog-remb\r\na=rtcp-fb:37 transport-cc\r\na=fmtp:37 repair-window=10000000\r\nm=application 9 UDP/DTLS/SCTP webrtc-datachannel\r\nc=IN IP4 0.0.0.0\r\na=ice-ufrag:6ReD\r\na=ice-pwd:QBmcZYd/t+InpMVkxQEEXnE4\r\na=ice-options:trickle\r\na=fingerprint:sha-256 DD:7E:6F:CD:B8:13:4E:37:D2:92:6D:8E:30:FB:FE:13:29:C9:F8:FD:78:0B:C4:59:42:61:BC:CF:02:91:6B:3C\r\na=setup:actpass\r\na=mid:2\r\na=sctp-port:5000\r\na=max-message-size:262144\r\n

Formatado:

v=0
o=- 2214114893783582286 2 IN IP4 127.0.0.1
s=-
t=0 0
a=group:BUNDLE 0 1 2
a=extmap-allow-mixed
a=msid-semantic: WMS
m=audio 9 UDP/TLS/RTP/SAVPF 111 63 103 104 9 0 8 106 105 13 110 112 113 126
c=IN IP4 0.0.0.0
a=rtcp:9 IN IP4 0.0.0.0
a=ice-ufrag:6ReD
a=ice-pwd:QBmcZYd/t+InpMVkxQEEXnE4
a=ice-options:trickle
a=fingerprint:sha-256 DD:7E:6F:CD:B8:13:4E:37:D2:92:6D:8E:30:FB:FE:13:29:C9:F8:FD:78:0B:C4:59:42:61:BC:CF:02:91:6B:3C
a=setup:actpass
a=mid:0
a=extmap:1 urn:ietf:params:rtp-hdrext:ssrc-audio-level
a=extmap:2 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time
a=extmap:3 http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01
a=extmap:4 urn:ietf:params:rtp-hdrext:sdes:mid
a=recvonly
a=rtcp-mux
a=rtpmap:111 opus/48000/2
a=rtcp-fb:111 transport-cc
a=fmtp:111 minptime=10;useinbandfec=1
a=rtpmap:63 red/48000/2
a=fmtp:63 111/111
a=rtpmap:103 ISAC/16000
a=rtpmap:104 ISAC/32000
a=rtpmap:9 G722/8000
a=rtpmap:0 PCMU/8000
a=rtpmap:8 PCMA/8000
a=rtpmap:106 CN/32000
a=rtpmap:105 CN/16000
a=rtpmap:13 CN/8000
a=rtpmap:110 telephone-event/48000
a=rtpmap:112 telephone-event/32000
a=rtpmap:113 telephone-event/16000
a=rtpmap:126 telephone-event/8000
m=video 9 UDP/TLS/RTP/SAVPF 96 97 98 99 100 101 122 102 121 127 120 125 107 108 109 35 36 124 119 123 118 114 115 116 37
c=IN IP4 0.0.0.0
a=rtcp:9 IN IP4 0.0.0.0
a=ice-ufrag:6ReD
a=ice-pwd:QBmcZYd/t+InpMVkxQEEXnE4
a=ice-options:trickle
a=fingerprint:sha-256 DD:7E:6F:CD:B8:13:4E:37:D2:92:6D:8E:30:FB:FE:13:29:C9:F8:FD:78:0B:C4:59:42:61:BC:CF:02:91:6B:3C
a=setup:actpass
a=mid:1
a=extmap:14 urn:ietf:params:rtp-hdrext:toffset
a=extmap:2 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time
a=extmap:13 urn:3gpp:video-orientation
a=extmap:3 http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01
a=extmap:5 http://www.webrtc.org/experiments/rtp-hdrext/playout-delay
a=extmap:6 http://www.webrtc.org/experiments/rtp-hdrext/video-content-type
a=extmap:7 http://www.webrtc.org/experiments/rtp-hdrext/video-timing
a=extmap:8 http://www.webrtc.org/experiments/rtp-hdrext/color-space
a=extmap:4 urn:ietf:params:rtp-hdrext:sdes:mid
a=extmap:10 urn:ietf:params:rtp-hdrext:sdes:rtp-stream-id
a=extmap:11 urn:ietf:params:rtp-hdrext:sdes:repaired-rtp-stream-id
a=recvonly
a=rtcp-mux
a=rtcp-rsize
a=rtpmap:96 VP8/90000
a=rtcp-fb:96 goog-remb
a=rtcp-fb:96 transport-cc
a=rtcp-fb:96 ccm fir
a=rtcp-fb:96 nack
a=rtcp-fb:96 nack pli
a=rtpmap:97 rtx/90000
a=fmtp:97 apt=96
a=rtpmap:98 VP9/90000
a=rtcp-fb:98 goog-remb
a=rtcp-fb:98 transport-cc
a=rtcp-fb:98 ccm fir
a=rtcp-fb:98 nack
a=rtcp-fb:98 nack pli
a=fmtp:98 profile-id=0
a=rtpmap:99 rtx/90000
a=fmtp:99 apt=98
a=rtpmap:100 VP9/90000
a=rtcp-fb:100 goog-remb
a=rtcp-fb:100 transport-cc
a=rtcp-fb:100 ccm fir
a=rtcp-fb:100 nack
a=rtcp-fb:100 nack pli
a=fmtp:100 profile-id=2
a=rtpmap:101 rtx/90000
a=fmtp:101 apt=100
a=rtpmap:122 VP9/90000
a=rtcp-fb:122 goog-remb
a=rtcp-fb:122 transport-cc
a=rtcp-fb:122 ccm fir
a=rtcp-fb:122 nack
a=rtcp-fb:122 nack pli
a=fmtp:122 profile-id=1
a=rtpmap:102 H264/90000
a=rtcp-fb:102 goog-remb
a=rtcp-fb:102 transport-cc
a=rtcp-fb:102 ccm fir
a=rtcp-fb:102 nack
a=rtcp-fb:102 nack pli
a=fmtp:102 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=42001f
a=rtpmap:121 rtx/90000
a=fmtp:121 apt=102
a=rtpmap:127 H264/90000
a=rtcp-fb:127 goog-remb
a=rtcp-fb:127 transport-cc
a=rtcp-fb:127 ccm fir
a=rtcp-fb:127 nack
a=rtcp-fb:127 nack pli
a=fmtp:127 level-asymmetry-allowed=1;packetization-mode=0;profile-level-id=42001f
a=rtpmap:120 rtx/90000
a=fmtp:120 apt=127
a=rtpmap:125 H264/90000
a=rtcp-fb:125 goog-remb
a=rtcp-fb:125 transport-cc
a=rtcp-fb:125 ccm fir
a=rtcp-fb:125 nack
a=rtcp-fb:125 nack pli
a=fmtp:125 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=42e01f
a=rtpmap:107 rtx/90000
a=fmtp:107 apt=125
a=rtpmap:108 H264/90000
a=rtcp-fb:108 goog-remb
a=rtcp-fb:108 transport-cc
a=rtcp-fb:108 ccm fir
a=rtcp-fb:108 nack
a=rtcp-fb:108 nack pli
a=fmtp:108 level-asymmetry-allowed=1;packetization-mode=0;profile-level-id=42e01f
a=rtpmap:109 rtx/90000
a=fmtp:109 apt=108
a=rtpmap:35 AV1/90000
a=rtcp-fb:35 goog-remb
a=rtcp-fb:35 transport-cc
a=rtcp-fb:35 ccm fir
a=rtcp-fb:35 nack
a=rtcp-fb:35 nack pli
a=rtpmap:36 rtx/90000
a=fmtp:36 apt=35
a=rtpmap:124 H264/90000
a=rtcp-fb:124 goog-remb
a=rtcp-fb:124 transport-cc
a=rtcp-fb:124 ccm fir
a=rtcp-fb:124 nack
a=rtcp-fb:124 nack pli
a=fmtp:124 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=4d0032
a=rtpmap:119 rtx/90000
a=fmtp:119 apt=124
a=rtpmap:123 H264/90000
a=rtcp-fb:123 goog-remb
a=rtcp-fb:123 transport-cc
a=rtcp-fb:123 ccm fir
a=rtcp-fb:123 nack
a=rtcp-fb:123 nack pli
a=fmtp:123 level-asymmetry-allowed=1;packetization-mode=1;profile-level-id=640032
a=rtpmap:118 rtx/90000
a=fmtp:118 apt=123
a=rtpmap:114 red/90000
a=rtpmap:115 rtx/90000
a=fmtp:115 apt=114
a=rtpmap:116 ulpfec/90000
a=rtpmap:37 flexfec-03/90000
a=rtcp-fb:37 goog-remb
a=rtcp-fb:37 transport-cc
a=fmtp:37 repair-window=10000000
m=application 9 UDP/DTLS/SCTP webrtc-datachannel
c=IN IP4 0.0.0.0
a=ice-ufrag:6ReD
a=ice-pwd:QBmcZYd/t+InpMVkxQEEXnE4
a=ice-options:trickle
a=fingerprint:sha-256 DD:7E:6F:CD:B8:13:4E:37:D2:92:6D:8E:30:FB:FE:13:29:C9:F8:FD:78:0B:C4:59:42:61:BC:CF:02:91:6B:3C
a=setup:actpass
a=mid:2
a=sctp-port:5000
a=max-message-size:262144
Field Descrição Tipo de dados
offerSdp Uma oferta SDP, específica para o dispositivo local que exibirá a transmissão ao vivo WebRTC. string
Exemplo: "offerSdp"

Campos de resposta GenerateWebRtcStream

O answerSdp precisa ser usado para gerar a transmissão ao vivo até 30 segundos após o recebimento da resposta. Caso contrário, ele vai expirar. Se ele expirar, execute o comando GenerateWebRtcStream novamente para receber um novo answerSdp.

Ao abrir canais WebRTC para a transmissão ao vivo, crie um canal de dados e um canal de vídeo.

Field Descrição Tipo de dados
answerSdp Uma resposta SDP a ser usada com o dispositivo local que exibirá a transmissão ao vivo WebRTC. string
Exemplo: "answerSdp"
expiresAt Hora em que o acesso à transmissão ao vivo WebRTC expira, no formato RFC 3339. string
Exemplo: "2020-01-04T18:30:00.000Z"
mediaSessionId ID da sessão de mídia da transmissão ao vivo do WebRTC gerada. string
Exemplo: "-xglvYd3yxgIalLTq9gldicmPK..."

ExtendWebRtcStream

Nest Cam (legado) Nest Cam (interna ou externa, com bateria) Nest Cam com holofote Nest Cam (interna, com fio) Nest Doorbell (com fio)   Com fio   

Solicite que o acesso a uma transmissão ao vivo WebRTC existente seja estendido antes que ele expire.

Um stream WebRTC só pode ser estendido em câmeras com fio. Uma câmera que funciona por bateria é considerada ligada a fio quando está conectada para carregamento. Se a câmera estiver usando a energia da bateria, uma solicitação para estender um stream WebRTC ativo será ignorada.

As sessões de transmissão ao vivo da câmera só são válidas por 5 minutos. Se você precisar estender o ciclo de vida de uma transmissão ao vivo, use o comando "Estender"Format"Estender" da característica CameraLiveStream do formato de transmissão que você gerou.

Solicitação e resposta ExtendWebRtcStream

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.ExtendWebRtcStream",
  "params" : {
    "mediaSessionId" : "-xglvYd3yxgIalLTq9gldicmPK..."
  }
}

Resposta

{
  "results" : {
    "expiresAt" : "2018-01-04T18:30:00.000Z",
    "mediaSessionId" : "-xglvYd3yxgIalLTq9gldicmPK..."
  }
}

Campos de solicitação ExtendWebRtcStream

Field Descrição Tipo de dados
mediaSessionId ID da sessão de mídia do stream ao vivo do WebRTC que será estendido. string
Exemplo: "-xglvYd3yxgIalLTq9gldicmPK..."

Campos de resposta ExtendWebRtcStream

Field Descrição Tipo de dados
expiresAt O novo horário em que o acesso à transmissão ao vivo WebRTC expira, no formato RFC 3339. string
Exemplo: "2018-01-04T18:30:00.000Z"
mediaSessionId ID da sessão de mídia da transmissão ao vivo do WebRTC que foi estendida. string
Exemplo: "-xglvYd3yxgIalLTq9gldicmPK..."

StopWebRtcStream

Nest Cam (legado) Nest Cam (interna ou externa, com bateria) Nest Cam com holofote Nest Cam (interna, com fio) Nest Doorbell (com bateria) Nest Doorbell (com fio)

Invalida uma sessão de mídia WebRTC válida e interrompe a transmissão ao vivo WebRTC vinculada a essa sessão.

Solicitação e resposta de StopWebRtcStream

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopWebRtcStream",
  "params" : {
    "mediaSessionId" : "-xglvYd3yxgIalLTq9gldicmPK..."
  }
}

Resposta

{}

Campos de solicitação de StopWebRtcStream

Field Descrição Tipo de dados
mediaSessionId ID da sessão de mídia da transmissão ao vivo do WebRTC a ser interrompida. string
Exemplo: "-xglvYd3yxgIalLTq9gldicmPK..."

Erros

Os seguintes códigos de erro podem ser retornados em relação a essa característica:

Mensagem de erro RPC Solução de problemas
A câmera não está disponível para streaming. FAILED_PRECONDITION A câmera está off-line ou indisponível para streaming devido a um problema técnico.
O comando não é compatível com a campainha. FAILED_PRECONDITION Um stream WebRTC não pode ser estendido em campainhas com bateria. Se um stream em uma campainha precisar ser visto além da duração inicial da sessão, interrompa o stream existente e gere um novo.
Permissão negada. PERMISSION_DENIED O user não concedeu ao developer as permissões necessárias no nível do dispositivo no Partner Connections Manager (PCM) necessárias para executar um comando.

Ao gerar uma transmissão ao vivo WebRTC, esse erro também pode significar que a configuração de áudio no offerSdp está incorreta.

Consulte a Referência do código de erro da API para ver a lista completa de códigos de erro de API.