Esta página foi traduzida pela API Cloud Translation.

Esquema CameraLiveStream

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

sdm.devices.traits.CameraLiveStream

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

Campos

Campo	Descrição	Tipo de dados
`maxVideoResolution`	Resolução máxima da transmissão ao vivo.	`VideoResolution`
`videoCodecs`	Codecs de vídeo compatíveis com a transmissão ao vivo.	`array(string)` Value: ["H264"]
`audioCodecs`	Codecs de áudio compatíveis com a transmissão ao vivo.	`array(string)` Value: ["AAC"]
`supportedProtocols`	Protocolos de streaming compatíveis com o dispositivo. O valor desse campo indica quais comandos são compatíveis com o dispositivo. Por exemplo, se esse campo contiver WEB_RTC, apenas comandos WEB_RTC serão compatíveis. Se o dispositivo específico for uma Google Nest Cam Indoor ou uma Google Nest Cam Outdoor, ele poderá ser usado no app Nest ou no app Google Home. Quando a câmera está no app Nest, ela usa RTSP. Quando a câmera está no app Google Home, ela usa o WebRTC.	`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` 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 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 transmitir da mesma câmera ao mesmo tempo, os comandos RTSP precisarão ser enviados para cada cliente individual, e cada cliente individual precisará usar o próprio URL de stream.

Solicitação e resposta de 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 da 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` Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`streamToken`	Token usado para acessar uma transmissão ao vivo RTSP.	`string` Exemplo: "g.0.streamingToken"
`expiresAt`	Horário 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 de URL de transmissão ao vivo RTSP para substituir um token de acesso RTSP válido antes que ele expire. 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 por apenas 5 minutos. Se você precisar estender a duração de uma transmissão ao vivo, use o comando ExtendFormatStream apropriado da característica CameraLiveStream para o formato de transmissão gerado.

Solicitação e resposta de 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` Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."

Campos de resposta ExtendRtspStream

Campo	Descrição	Tipo de dados
`streamExtensionToken`	Token usado para ver uma transmissão ao vivo RTSP e solicitar uma extensão do token de streaming.	`string` Exemplo: "dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
`streamToken`	Novo token a ser usado para acessar uma transmissão ao vivo RTSP.	`string` Exemplo: "g.0.newStreamingToken"
`expiresAt`	Horário 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 RTSP válido e interrompe a transmissão ao vivo RTSP vinculada a esse token.

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 da solicitação StopRtspStream

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

GenerateWebRtcStream

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

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

Solicitação e resposta de 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" : "qn-WpZTuC32h_GEm0rJvEvyRYs..."
  }
}

Campos de solicitação GenerateWebRtcStream

Recomendamos usar o exemplo de aplicativo da Web para aprender a gerar uma transmissão ao vivo de sucesso. Este 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 é aceito.
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 \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 mostrar a transmissão ao vivo do WebRTC.	`string` Exemplo: "`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 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 de vídeo.

Campo	Descrição	Tipo de dados
`answerSdp`	Uma resposta SDP a ser usada com o dispositivo local que vai mostrar a transmissão ao vivo do WebRTC.	`string` Exemplo: "`answerSdp`"
`expiresAt`	O horário em que o acesso à transmissão ao vivo do 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 WebRTC gerada.	`string` Exemplo: "qn-WpZTuC32h_GEm0rJvEvyRYs..."

ExtendWebRtcStream

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

Solicitar a extensão do acesso a uma transmissão ao vivo do WebRTC antes que ele expire.

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

Solicitação e resposta de ExtendWebRtcStream

Solicitação

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

Resposta

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

Campos da solicitação ExtendWebRtcStream

Campo	Descrição	Tipo de dados
`mediaSessionId`	ID da sessão de mídia da transmissão ao vivo do WebRTC a ser estendida.	`string` Exemplo: "qn-WpZTuC32h_GEm0rJvEvyRYs..."

Campos de resposta ExtendWebRtcStream

Campo	Descrição	Tipo de dados
`expiresAt`	O novo horário em que o acesso à transmissão ao vivo do 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 WebRTC que foi estendida.	`string` Exemplo: "qn-WpZTuC32h_GEm0rJvEvyRYs..."

StopWebRtcStream

Nest Cam (legada) 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 do 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" : "qn-WpZTuC32h_GEm0rJvEvyRYs..."
  }
}

Resposta

{}

Campos da solicitação StopWebRtcStream

Campo	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: "qn-WpZTuC32h_GEm0rJvEvyRYs..."

Erros

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

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 transmissão devido a um problema técnico.
O comando não é compatível com a campainha.	`FAILED_PRECONDITION`	Não é possível estender um stream do WebRTC em campainhas com bateria. Se for necessário assistir uma transmissão de uma campainha por mais tempo do que a duração inicial da sessão, interrompa a transmissão atual e gere uma nova.
Permissão negada.	`PERMISSION_DENIED`	O user não concedeu ao developer as permissões adequadas no nível do dispositivo no Gerenciador de conexões de parceiros (PCM) necessárias para executar um comando. Ao gerar uma transmissão ao vivo do 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.