Esquema CameraLiveStream

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

sdm.devices.traits.CameraLiveStream

Esse trait pertence a qualquer dispositivo que ofereça suporte a transmissões ao vivo.

Campos

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

VideoResolution (maxVideoResolution)

Campo 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
Example: 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
Example: 480

Exemplo de solicitação GET e resposta

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 (legado) Nest Hub Max Nest Doorbell (legado) 

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

Os URLs de transmissão ao vivo RTSP não podem ser compartilhados entre clientes. Um URL de stream só pode ser usado por um cliente por vez. Se vários clientes quiserem fazer streaming da mesma câmera ao mesmo tempo, os comandos RTSP precisam ser enviados para cada cliente individual, e cada cliente individual precisa 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

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

ExtendRtspStream

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

Solicite um novo token de acesso ao URL de transmissão ao vivo RTSP para substituir um token de acesso 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ão válidas apenas por 5 minutos. Se você precisar estender a vida útil de uma transmissão ao vivo, use o comando ExtendFormatStream apropriado do CameraLiveStream trait para o formato de stream gerado.

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

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

Campos de resposta ExtendRtspStream

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

StopRtspStream

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

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

Solicitação e resposta 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 StopRtspStream

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

GenerateWebRtcStream

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

Gere 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" : "Tp-TEPvJ8Qseo3FShZCAFjXopl..."
  }
}

Campos de solicitação GenerateWebRtcStream

Recomendamos usar o exemplo de aplicativo da Web para aprender a gerar uma transmissão ao vivo bem-sucedida. Esse exemplo gera um offerSdp válido que atende a todas as restrições de oferta de SDP para câmeras Nest.

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

  • Somente o formato unificado é compatível. O plano B não é compatível.
  • Todas as linhas de mídia (m=) precisam estar presentes na oferta e 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.

Confira um exemplo de oferta válida

Não formatado:

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
Campo Descrição Tipo de dados
offerSdp Uma oferta de SDP, específica para o dispositivo local que vai exibir a transmissão ao vivo WebRTC. string
Example: "offerSdp"

Campos de resposta GenerateWebRtcStream

O answerSdp precisa ser usado para gerar a transmissão ao vivo em até 30 segundos após o recebimento da resposta. Caso contrário, ele expira. Se ele expirar, execute o GenerateWebRtcStream comando 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.

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

ExtendWebRtcStream

Nest Cam (legado) Nest Cam (externa ou interna, 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 seja estendido antes que ela expire.

Um stream WebRTC só pode ser estendido em câmeras com fio. Uma câmera com bateria é considerada com fio quando conectada para carregar. Se a câmera estiver com bateria, uma solicitação para estender um stream WebRTC ativo será ignorada.

As sessões de transmissão ao vivo da câmera são válidas apenas por 5 minutos. Se você precisar estender a vida útil de uma transmissão ao vivo, use o comando ExtendFormatStream apropriado do CameraLiveStream trait para o formato de stream gerado.

Solicitação e resposta ExtendWebRtcStream

Solicitação

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

Resposta

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

Campos de solicitação ExtendWebRtcStream

Campo Descrição Tipo de dados
mediaSessionId ID da sessão de mídia da transmissão ao vivo WebRTC a ser estendida. string
Example: "Tp-TEPvJ8Qseo3FShZCAFjXopl..."

Campos de resposta ExtendWebRtcStream

Campo 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
Example: "2018-01-04T18:30:00.000Z"
mediaSessionId ID da sessão de mídia da transmissão ao vivo WebRTC que foi estendida. string
Example: "Tp-TEPvJ8Qseo3FShZCAFjXopl..."

StopWebRtcStream

Nest Cam (legado) Nest Cam (externa ou interna, 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 StopWebRtcStream

Solicitação

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

Resposta

{}

Campos de solicitação StopWebRtcStream

Campo Descrição Tipo de dados
mediaSessionId ID da sessão de mídia da transmissão ao vivo WebRTC a ser interrompida. string
Example: "Tp-TEPvJ8Qseo3FShZCAFjXopl..."

Erros

Os seguintes códigos de erro podem ser retornados em relação a esse trait:

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 não está disponí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 visualizado além da duração da sessão inicial, interrompa o stream atual e gere um novo.
Permissão negada. PERMISSION_DENIED O user não concedeu ao developer as permissões apropriadas no nível do dispositivo no Partner Connections Manager (PCM, na sigla em inglês) 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 de códigos de erro da API para conferir a lista completa de códigos de erro da API.