Esta página foi traduzida pela API Cloud Translation.

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

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 de vídeo.	`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 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, somente os comandos WEB_RTC serão aceitos. Se o dispositivo específico for uma Nest Cam Indoor ou uma Nest Cam Outdoor, ele poderá ser usado no app Nest ou no Google Home. Quando a câmera estiver no app Nest, ela vai usar RTSP. E quando a câmera está no app Google Home, ela usa o WebRTC.	`array(string)` Valor: ["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 (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 transmissão 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 precisarão ser enviados para cada cliente individualmente, e cada um deles precisará usar o próprio URL de streaming.

Solicitação e resposta do método 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 de GenerateRtspStream

Campo	Descrição	Tipo de dados
`streamUrls`	Mapa de URLs de transmissões ao vivo RTSP.	`object`
`streamExtensionToken`	Token a ser usado para estender o `streamToken` em uma transmissão ao vivo RTSP.	`string` Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`streamToken`	Token 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 (legado) Nest Hub Max Nest Doorbell (legado)

Solicite um novo token de acesso ao URL da transmissão RTSP ao vivo para substituir um token de acesso RTSP válido antes que ele expire. Ele 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 adequado da característica CameraLiveStream do formato de transmissão que você criou.

Solicitação e resposta do 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 de ExtendRtspStream

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

Campos de resposta de ExtendRtspStream

Campo	Descrição	Tipo de dados
`streamExtensionToken`	Token usado para conferir uma transmissão ao vivo RTSP e solicitar uma extensão para o token de streaming.	`string` Exemplo: "dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
`streamToken`	Novo token 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 (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 do 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 (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)

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

Solicitação e resposta do método 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" : "228YfMrGPFS7fVx74vttyJj-hG..."
  }
}

Campos de solicitação de GenerateWebRtcStream

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

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

Somente o formato unificado é aceito. O plano B não é compatível.
Todas as linhas de mídia (m=) precisam estar presentes na oferta e precisam estar nesta ordem:
1. áudio
2. vídeo
3. aplicativo
O Trickle ICE é aceito, 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.

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

Campo	Descrição	Tipo de dados
`offerSdp`	Uma oferta SDP específica para o dispositivo local que vai mostrar a transmissão ao vivo do WebRTC.	`string` Exemplo: "`offerSdp`"

Campos de resposta de 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 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 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`	Hora 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 do WebRTC gerada.	`string` Exemplo: "228YfMrGPFS7fVx74vttyJj-hG…"

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 a extensão do acesso a uma transmissão ao vivo do WebRTC antes que ela expire.

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

Solicitação e resposta do ExtendWebRtcStream

Solicitação

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

Resposta

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

Campos de solicitação de ExtendWebRtcStream

Campo	Descrição	Tipo de dados
`mediaSessionId`	O ID da sessão de mídia da transmissão ao vivo do WebRTC será estendido.	`string` Exemplo: "228YfMrGPFS7fVx74vttyJj-hG…"

Campos de resposta de ExtendWebRtcStream

Campo	Descrição	Tipo de dados
`expiresAt`	O novo horário de expiração do acesso à transmissão ao vivo do WebRTC, 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: "228YfMrGPFS7fVx74vttyJj-hG…"

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 válida do WebRTC 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" : "228YfMrGPFS7fVx74vttyJj-hG..."
  }
}

Resposta

{}

Campos de solicitação StopWebRtcStream

Campo	Descrição	Tipo de dados
`mediaSessionId`	O ID da sessão de mídia da transmissão ao vivo do WebRTC a ser interrompida.	`string` Exemplo: "228YfMrGPFS7fVx74vttyJj-hG…"

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 não está disponível para streaming devido a um problema técnico.
O comando não é compatível com a campainha.	`FAILED_PRECONDITION`	Não é possível estender um fluxo WebRTC 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 adequadas no nível do dispositivo no Partner Connections Manager (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.