Ta strona została przetłumaczona przez Cloud Translation API.

Schemat CameraLiveStream

Nest Cam (starsza wersja) Nest Cam (zewnętrzna lub wewnętrzna, zasilana bateryjnie) Nest Cam z oświetleniem Nest Cam (wewnętrzna, zasilana z sieci) Nest Hub Max Nest Doorbell (starsza wersja) Nest Doorbell (zasilany bateryjnie) Nest Doorbell (zasilany z sieci)

sdm.devices.traits.CameraLiveStream

Ten atrybut należy do każdego urządzenia, które obsługuje transmisje na żywo.

Pola

Pole	Opis	Typ danych
`maxVideoResolution`	Maksymalna rozdzielczość transmisji na żywo.	`VideoResolution`
`videoCodecs`	Kodeki wideo obsługiwane w przypadku transmisji na żywo.	`array(string)` Value: ["H264"]
`audioCodecs`	Kodeki audio obsługiwane w transmisji na żywo.	`array(string)` Value: ["AAC"]
`supportedProtocols`	Protokoły transmisji strumieniowej obsługiwane przez urządzenie. Wartość tego pola wskazuje, które polecenia są obsługiwane przez urządzenie. Jeśli na przykład to pole zawiera WEB_RTC, obsługiwane są tylko polecenia WEB_RTC. Jeśli urządzenie to Google Nest Cam Indoor lub Google Nest Cam Outdoor, można go używać w aplikacji Nest lub Google Home. Gdy kamera jest w aplikacji Nest, korzysta z protokołu RTSP. Gdy kamera jest w aplikacji Google Home, korzysta z WebRTC.	`array(string)` Wartość: ["RTSP", "WEB_RTC"]

VideoResolution (maxVideoResolution)

Pole	Opis	Typ danych
`width`	Maksymalna szerokość rozdzielczości obrazu. Może też być używany jako parametr zapytania w adresie URL pobierania.	`int32` Przykład: 640
`height`	Maksymalna wysokość rozdzielczości obrazu. Może też być używany jako parametr zapytania w adresie URL pobierania.	`int32` Przykład: 480

Przykładowe żądanie GET i odpowiedź

Żądanie

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

Odpowiedź

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

Polecenia

GenerateRtspStream

Nest Cam (starsza wersja) Nest Hub Max Nest Doorbell (starsza wersja)

Poproś o token umożliwiający dostęp do adresu URL transmisji na żywo w RTSP.

Adresów URL transmisji na żywo RTSP nie można udostępniać między klientami. Adres URL transmisji może być używany tylko przez jednego klienta naraz. Jeśli wielu klientów chce przesyłać strumieniowo obraz z tej samej kamery w tym samym czasie, polecenia RTSP muszą być wysyłane do każdego klienta z osobna, a każdy klient musi używać własnego adresu URL strumienia.

Żądanie i odpowiedź GenerateRtspStream

Żądanie

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

Odpowiedź

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

Pola odpowiedzi GenerateRtspStream

Pole	Opis	Typ danych
`streamUrls`	Mapa adresów URL transmisji na żywo RTSP.	`object`
`streamExtensionToken`	Token używany do przedłużenia `streamToken` w przypadku transmisji na żywo RTSP.	`string` Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`streamToken`	Token używany do uzyskiwania dostępu do transmisji na żywo RTSP.	`string` Przykład: „g.0.streamingToken”
`expiresAt`	Czas wygaśnięcia obu tokenów `streamExtensionToken` i `streamToken` w formacie RFC 3339.	`string` Przykład: „2018-01-04T18:30:00.000Z”

ExtendRtspStream

Nest Cam (starsza wersja) Nest Hub Max Nest Doorbell (starsza wersja)

Poproś o nowy token dostępu do adresu URL transmisji na żywo RTSP, aby zastąpić nim ważny token dostępu RTSP przed jego wygaśnięciem. Jest on też używany do zastępowania prawidłowego tokena RTSP z poprzedniego żądania polecenia ExtendRtspStream.

Sesje transmisji na żywo z kamery są ważne tylko przez 5 minut. Jeśli chcesz przedłużyć czas trwania transmisji na żywo, użyj odpowiedniego polecenia ExtendFormatStream z cechy CameraLiveStream dla wygenerowanego formatu strumienia.

Żądanie i odpowiedź ExtendRtspStream

Żądanie

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

Odpowiedź

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

Pola żądania ExtendRtspStream

Pole	Opis	Typ danych
`streamExtensionToken`	Token używany do wysyłania prośby o przedłużenie ważności tokena przesyłania strumieniowego RTSP.	`string` Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF..."

Pola odpowiedzi ExtendRtspStream

Pole	Opis	Typ danych
`streamExtensionToken`	Token używany do wyświetlania istniejącej transmisji na żywo RTSP i do wysyłania próśb o przedłużenie ważności tokena strumieniowania.	`string` Przykład: „dGNUlTU2CjY5Y3VKaTZwR3o4Y1...”.
`streamToken`	Nowy token do uzyskiwania dostępu do istniejącej transmisji na żywo RTSP.	`string` Przykład: „g.0.newStreamingToken”
`expiresAt`	Czas wygaśnięcia obu tokenów `streamExtensionToken` i `streamToken` w formacie RFC 3339.	`string` Przykład: „2018-01-04T18:30:00.000Z”

StopRtspStream

Nest Cam (starsza wersja) Nest Hub Max Nest Doorbell (starsza wersja)

Unieważnia prawidłowy token dostępu RTSP i zatrzymuje transmisję na żywo RTSP powiązaną z tym tokenem dostępu.

Żądanie i odpowiedź StopRtspStream

Żądanie

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

Odpowiedź

{}

Pola żądania StopRtspStream

Pole	Opis	Typ danych
`streamExtensionToken`	Token do unieważnienia istniejącej transmisji na żywo RTSP.	`string` Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF..."

GenerateWebRtcStream

Nest Cam (starsza wersja) Nest Cam (zewnętrzna lub wewnętrzna, zasilana bateryjnie) Nest Cam z oświetleniem Nest Cam (wewnętrzna, zasilana z sieci) Nest Doorbell (zasilany bateryjnie) Nest Doorbell (zasilany z sieci)

Wygeneruj transmisję na żywo WebRTC na urządzenie.

Żądanie i odpowiedź GenerateWebRtcStream

Żądanie

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

Odpowiedź

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

Pola żądania GenerateWebRtcStream

Aby dowiedzieć się, jak utworzyć skuteczną transmisję na żywo, zalecamy skorzystanie z przykładowej aplikacji internetowej. Ten przykład generuje prawidłowy offerSdp, który spełnia wszystkie ograniczenia oferty SDP dla kamer Nest.

Oferta SDP dla kamer Nest musi spełniać te ograniczenia:

Obsługiwany jest tylko format Unified. Plan B nie jest obsługiwany.
Wszystkie wiersze multimediów (m=) muszą być obecne w ofercie i muszą być w tej kolejności:
1. dźwięk
2. film
3. aplikacja
Trickle ICE jest obsługiwany, ale nie jest wymagany.
W przypadku dźwięku obsługiwany jest tylko kodek Opus.
Ustawienie audio musi być ustawione na a=recvonly (tylko odbieranie).
Oferta musi kończyć się znakiem nowego wiersza \r\n lub \n.

Zobacz przykład prawidłowej oferty

Niesformatowany:

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

Sformatowano:

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

Pole	Opis	Typ danych
`offerSdp`	Oferta SDP, która jest specyficzna dla urządzenia lokalnego, na którym będzie wyświetlana transmisja na żywo WebRTC.	`string` Przykład: „`offerSdp`”

Pola odpowiedzi GenerateWebRtcStream

answerSdp musi zostać użyty do wygenerowania transmisji na żywo w ciągu 30 sekund od otrzymania odpowiedzi, w przeciwnym razie wygaśnie. Jeśli wygaśnie, ponownie wykonaj polecenie GenerateWebRtcStream, aby otrzymać nowy answerSdp.

Podczas otwierania kanałów WebRTC dla transmisji na żywo utwórz zarówno kanał danych, jak i kanał wideo.

Pole	Opis	Typ danych
`answerSdp`	Odpowiedź SDP, która będzie używana na urządzeniu lokalnym wyświetlającym transmisję na żywo WebRTC.	`string` Przykład: „`answerSdp`”
`expiresAt`	Czas, w którym wygasa dostęp do transmisji na żywo WebRTC, w formacie RFC 3339.	`string` Przykład: „2020-01-04T18:30:00.000Z”
`mediaSessionId`	Identyfikator sesji multimedialnej wygenerowanej transmisji na żywo WebRTC.	`string` Przykład: „5TbN9Y7jsz58_2sX5Pnfn-R81M...”.

ExtendWebRtcStream

Nest Cam (starsza wersja) Nest Cam (zewnętrzna lub wewnętrzna, zasilana bateryjnie) Nest Cam z oświetleniem Nest Cam (wewnętrzna, zasilana z sieci) Nest Doorbell (zasilany z sieci) Zasilane z sieci

Poproś o przedłużenie dostępu do istniejącej transmisji na żywo WebRTC przed jego wygaśnięciem.

Strumień WebRTC można przedłużyć tylko w przypadku kamer zasilanych przewodowo. Kamera zasilana bateryjnie jest uważana za zasilaną przewodowo, gdy jest podłączona do ładowania. Jeśli kamera jest zasilana bateryjnie, żądanie przedłużenia aktywnej transmisji WebRTC zostanie zignorowane.

Żądanie i odpowiedź ExtendWebRtcStream

Żądanie

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

Odpowiedź

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

Pola żądania ExtendWebRtcStream

Pole	Opis	Typ danych
`mediaSessionId`	Identyfikator sesji multimedialnej transmisji na żywo WebRTC, która ma zostać przedłużona.	`string` Przykład: „5TbN9Y7jsz58_2sX5Pnfn-R81M...”.

Pola odpowiedzi ExtendWebRtcStream

Pole	Opis	Typ danych
`expiresAt`	Nowy czas wygaśnięcia dostępu do transmisji na żywo WebRTC w formacie RFC 3339.	`string` Przykład: „2018-01-04T18:30:00.000Z”
`mediaSessionId`	Identyfikator sesji multimedialnej transmisji na żywo WebRTC, która została przedłużona.	`string` Przykład: „5TbN9Y7jsz58_2sX5Pnfn-R81M...”.

StopWebRtcStream

Unieważnia prawidłową sesję multimedialną WebRTC i zatrzymuje transmisję na żywo WebRTC powiązaną z tą sesją.

Żądanie i odpowiedź StopWebRtcStream

Żądanie

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

Odpowiedź

{}

Pola żądania StopWebRtcStream

Pole	Opis	Typ danych
`mediaSessionId`	Identyfikator sesji multimedialnej transmisji na żywo WebRTC, którą chcesz zatrzymać.	`string` Przykład: „5TbN9Y7jsz58_2sX5Pnfn-R81M...”.

Błędy

W związku z tym atrybutem mogą być zwracane te kody błędów:

Komunikat o błędzie	RPC	Rozwiązywanie problemów
Kamera nie jest dostępna do przesyłania strumieniowego.	`FAILED_PRECONDITION`	Kamera jest offline lub niedostępna do przesyłania strumieniowego z powodu problemu technicznego.
Polecenie nie jest obsługiwane w przypadku dzwonka.	`FAILED_PRECONDITION`	Strumienia WebRTC nie można przedłużyć w przypadku dzwonków zasilanych bateryjnie. Jeśli strumień z dzwonka ma być wyświetlany dłużej niż w ramach początkowej sesji, zatrzymaj bieżący strumień i wygeneruj nowy.
Odmowa dostępu.	`PERMISSION_DENIED`	user nie przyznał developer odpowiednich uprawnień na poziomie urządzenia w Menedżerze połączeń z partnerami (PCM), które są wymagane do wykonania polecenia .Podczas generowania transmisji na żywo WebRTC ten błąd może też oznaczać, że ustawienie dźwięku w `offerSdp` jest nieprawidłowe.

Pełną listę kodów błędów interfejsu API znajdziesz w dokumentacji kodów błędów interfejsu API.