Diese Seite wurde von der Cloud Translation API übersetzt.

CameraLiveStream-Schema

Nest Cam (alte Version) Nest Cam (Outdoor oder Indoor, mit Akku) Nest Cam mit Flutlicht Nest Cam (Indoor, mit Kabel) Nest Cam (Indoor, mit Kabel) Nest Cam (Indoor, mit Kabel)Nest Hub Nest Hub Nest Hub

sdm.devices.traits.CameraLiveStream

Diese Eigenschaft gehört zu jedem Gerät, das Livestreaming unterstützt.

Felder

Field	Beschreibung	Datentyp
`maxVideoResolution`	Die maximale Auflösung des Video-Livestreams.	`VideoResolution`
`videoCodecs`	Für den Livestream unterstützte Video-Codecs.	`array(string)` Wert: ["H264"]
`audioCodecs`	Für den Livestream unterstützte Audio-Codecs.	`array(string)` Wert: ["AAC"]
`supportedProtocols`	Vom Gerät unterstützte Streaming-Protokolle. Der Wert in diesem Feld gibt an, welche Befehle für das Gerät unterstützt werden. Wenn dieses Feld beispielsweise WEB_RTC enthält, werden nur WEB_RTC-Befehle unterstützt. Wenn es sich bei dem Gerät um eine Google Nest Cam Indoor oder Google Nest Cam Outdoor handelt, kann es entweder in der Nest App oder der Google Home App verwendet werden. Ist die Kamera in der Nest App aktiv, wird RTSP verwendet. Und wenn sich die Kamera in der Google Home App befindet, verwendet sie WebRTC.	`array(string)` Wert: ["RTSP", "WEB_RTC"]

VideoResolution (maxVideoResolution)

Field	Beschreibung	Datentyp
`width`	Maximale Bildauflösungsbreite. Kann auch als Suchparameter in der Download-URL verwendet werden.	`int32` Beispiel: 640
`height`	Maximale Höhe der Bildauflösung. Kann auch als Suchparameter in der Download-URL verwendet werden.	`int32` Beispiel: 480

Beispiel für GET-Anfrage und -Antwort

Anfragen

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

Antwort

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

Befehle

GenerateRtspStream

Nest Cam (alte Version) Nest Hub Max Nest Doorbell (alte Version)

Fordern Sie ein Token für den Zugriff auf eine RTSP-Livestream-URL an.

RTSP-Livestream-URLs können nicht zwischen Clients geteilt werden. Eine Stream-URL kann immer nur von einem Client verwendet werden. Wenn mehrere Clients gleichzeitig von derselben Kamera streamen möchten, müssen RTSP-Befehle für jeden einzelnen Client gesendet werden und jeder Client muss seine eigene Stream-URL verwenden.

GenerateRtspStream-Anfrage und -Antwort

Anfragen

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

Antwort

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

GenerateRtspStream-Antwortfelder

Field	Beschreibung	Datentyp
`streamUrls`	Zuordnung der RTSP-Livestream-URLs.	`object`
`streamExtensionToken`	Token zum Erweitern von `streamToken` für einen RTSP-Livestream.	`string` Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
`streamToken`	Token für den Zugriff auf einen RTSP-Livestream.	`string` Beispiel: „g.0.streamingToken“
`expiresAt`	Zeitpunkt, zu dem sowohl `streamExtensionToken` als auch `streamToken` ablaufen, im RFC 3339-Format.	`string` Beispiel: „2018-01-04T18:30:00.000Z“

ExtendRtspStream

Nest Cam (alte Version) Nest Hub Max Nest Doorbell (alte Version)

Fordere ein neues RTSP-Live-Stream-URL-Zugriffstoken an, um ein gültiges RTSP-Zugriffstoken zu ersetzen, bevor es abläuft. Damit wird auch ein gültiges RTSP-Token aus einer vorherigen ExtendRtspStream-Befehlsanfrage ersetzt.

Livestream-Sitzungen mit Kamera sind nur 5 Minuten lang gültig. Wenn du die Lebensdauer eines Livestreams verlängern möchtest, verwende den entsprechenden Befehl „ExtendFormatStream“ der Funktion CameraLiveStream für das generierte Streamformat.

ExtendRtspStream-Anfrage und -Antwort

Anfragen

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

Antwort

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

ExtendRtspStream-Anfragefelder

Field	Beschreibung	Datentyp
`streamExtensionToken`	Token zum Anfordern einer Erweiterung für das RTSP-Streaming-Token.	`string` Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“

ExtendRtspStream-Antwortfelder

Field	Beschreibung	Datentyp
`streamExtensionToken`	Token, mit dem ein vorhandener RTSP-Livestream angesehen und eine Verlängerung des Streaming-Tokens angefordert wird.	`string` Beispiel: „dGNUlTU2CjY5Y3VKaTZwR3o4Y1...“
`streamToken`	Neues Token für den Zugriff auf einen vorhandenen RTSP-Livestream.	`string` Beispiel: „g.0.newStreamingToken“
`expiresAt`	Zeitpunkt, zu dem sowohl `streamExtensionToken` als auch `streamToken` ablaufen, im RFC 3339-Format.	`string` Beispiel: „2018-01-04T18:30:00.000Z“

StopRtspStream

Nest Cam (alte Version) Nest Hub Max Nest Doorbell (alte Version)

Ungültig macht ein gültiges RTSP-Zugriffstoken und stoppt den RTSP-Livestream, der mit diesem Zugriffstoken verknüpft ist.

StopRtspStream-Anfrage und -Antwort

Anfragen

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

Antwort

{}

StopRtspStream-Anfragefelder

Field	Beschreibung	Datentyp
`streamExtensionToken`	Token zur Entwertung eines vorhandenen RTSP-Livestreams.	`string` Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“

GenerateWebRtcStream

Nest Cam (alt) Nest Cam (Outdoor oder Indoor, mit Akku) Nest Cam mit Flutlicht Nest Cam (Indoor, mit Kabel) Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel)

WebRTC-Livestream für ein Gerät generieren

GenerateWebRtcStream-Anfrage und -Antwort

Anfragen

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

Antwort

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

GenerateWebRtcStream-Anfragefelder

Wir empfehlen, das Web Application Sample (Webanwendungsbeispiel) zu verwenden, um zu erfahren, wie du einen erfolgreichen Livestream erstellst. Dieses Beispiel generiert einen gültigen offerSdp, der alle SDP-Angebotseinschränkungen für Nest-Kameras erfüllt.

Bei einem SDP-Angebot für Nest-Kameras müssen die folgenden Einschränkungen eingehalten werden:

Es wird nur das einheitliche Format unterstützt. Tarif B wird nicht unterstützt.
Alle Medienzeilen (m=) müssen im Angebot vorhanden und in dieser Reihenfolge sein:
1. Audiotracks
2. Video
3. Anwendung
Trickle ICE wird unterstützt, ist aber nicht erforderlich.
Für Audio wird nur der Opus-Codec unterstützt.
Die Audioeinstellung muss auf a=recvonly (nur Empfang) festgelegt sein.
Das Angebot muss mit einem Zeilenumbruchzeichen wie „\r\n“ oder „\n“ enden.

Beispiel für ein gültiges Angebot

Nicht formatiert:

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

Formatiert:

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	Beschreibung	Datentyp
`offerSdp`	Ein SDP-Angebot, das speziell für das lokale Gerät gilt, auf dem der WebRTC-Livestream angezeigt wird.	`string` Beispiel: „`offerSdp`“

GenerateWebRtcStream-Antwortfelder

answerSdp muss verwendet werden, um den Livestream innerhalb von 30 Sekunden nach Erhalt der Antwort zu generieren. Andernfalls läuft er ab. Wenn er abläuft, führen Sie den Befehl GenerateWebRtcStream noch einmal aus, um einen neuen answerSdp zu erhalten.

Wenn Sie WebRTC-Kanäle für den Livestream öffnen, müssen Sie einen Datenkanal und einen Videokanal erstellen.

Field	Beschreibung	Datentyp
`answerSdp`	Eine SDP-Antwort, die auf dem lokalen Gerät verwendet wird, auf dem der WebRTC-Livestream angezeigt wird.	`string` Beispiel: „`answerSdp`“
`expiresAt`	Zeitpunkt, zu dem der Zugriff auf den WebRTC-Livestream abläuft. Die Angabe erfolgt im RFC 3339-Format.	`string` Beispiel: „2020-01-04T18:30:00.000Z“
`mediaSessionId`	Mediensitzungs-ID des generierten WebRTC-Livestreams.	`string` Beispiel: „QW_yv1uYh-WRDT6K8ZFuVywm5v...“

ExtendWebRtcStream

Nest Cam (alt) Nest Cam (Outdoor oder Indoor, mit Akku) Nest Cam mit Flutlicht Nest Cam (Indoor, mit Kabel) Nest Doorbell (mit Kabel) Mit Kabel

Sie können beantragen, dass der Zugriff auf einen bestehenden WebRTC-Livestream verlängert wird, bevor er abläuft.

Ein WebRTC-Stream kann nur bei kabelgebundenen Kameras erweitert werden. Eine batteriebetriebene Kamera wird als kabelbetrieben angesehen, wenn sie zum Laden an die Stromversorgung angeschlossen ist. Wenn die Kamera im Akkubetrieb ist, wird eine Anfrage zur Verlängerung eines aktiven WebRTC-Streams ignoriert.

ExtendWebRtcStream-Anfrage und -Antwort

Anfragen

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

Antwort

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

ExtendWebRtcStream-Anfragefelder

Field	Beschreibung	Datentyp
`mediaSessionId`	Mediensitzungs-ID des WebRTC-Livestreams, der erweitert werden soll.	`string` Beispiel: „QW_yv1uYh-WRDT6K8ZFuVywm5v...“

ExtendWebRtcStream-Antwortfelder

Field	Beschreibung	Datentyp
`expiresAt`	Die neue Zeit im RFC 3339-Format, zu der der Zugriff auf den WebRTC-Livestream abläuft.	`string` Beispiel: „2018-01-04T18:30:00.000Z“
`mediaSessionId`	Mediensitzungs-ID des erweiterten WebRTC-Livestreams.	`string` Beispiel: „QW_yv1uYh-WRDT6K8ZFuVywm5v...“

StopWebRtcStream

Nest Cam (alt) Nest Cam (Outdoor oder Indoor, mit Akku) Nest Cam mit Flutlicht Nest Cam (Indoor, mit Kabel) Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel)

Eine gültige WebRTC-Mediensitzung wird ungültig gemacht und der WebRTC-Livestream beendet, der mit dieser Sitzung verknüpft ist.

StopWebRtcStream-Anfrage und -Antwort

Anfragen

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

Antwort

{}

StopWebRtcStream-Anfragefelder

Field	Beschreibung	Datentyp
`mediaSessionId`	Mediensitzungs-ID des WebRTC-Livestreams, der beendet werden soll.	`string` Beispiel: „QW_yv1uYh-WRDT6K8ZFuVywm5v...“

Fehler

Die folgenden Fehlercodes können in Bezug auf dieses Merkmal zurückgegeben werden:

Fehlermeldung	RPC	Fehlerbehebung
Der Befehl wird für die Türklingel nicht unterstützt.	`FAILED_PRECONDITION`	Ein WebRTC-Stream kann bei akkubetriebenen Türklingeln nicht verlängert werden. Wenn ein Stream an einer Türklingel über die anfängliche Sitzungsdauer hinaus angesehen werden muss, beenden Sie den vorhandenen Stream und generieren Sie einen neuen.
Berechtigung verweigert.	`PERMISSION_DENIED`	Der user hat im Partner Connections Manager (PCM) nicht die entsprechenden developerBerechtigungen auf Geräteebene gewährt, die zum Ausführen eines Befehls erforderlich sind. Bei der Generierung eines WebRTC-Livestreams kann dieser Fehler auch bedeuten, dass die Audioeinstellung im `offerSdp` falsch ist.

Eine vollständige Liste der API-Fehlercodes finden Sie in der API-Fehlercode-Referenz.