本頁面由 Cloud Translation API 翻譯而成。

CameraLiveStream 結構定義

Nest Cam (舊版) Nest Cam (室內外兩用，電池版) Nest Cam Indoor (搭配泛光燈) Nest Cam Indoor Nest DoorbellNest Doorbell

sdm.devices.traits.CameraLiveStream

這項 trait 屬於任何支援直播功能的裝置。

欄位

欄位	說明	資料類型
`maxVideoResolution`	影片直播的最大解析度。	`VideoResolution`
`videoCodecs`	直播影片支援的影片轉碼器。	`array(string)` 值：["H264"]
`audioCodecs`	直播支援的音訊轉碼器。	`array(string)` 值：["AAC"]
`supportedProtocols`	裝置支援的串流通訊協定。這個欄位的值表示裝置支援哪些指令。例如，如果這個欄位包含 WEB_RTC，僅支援 WEB_RTC 指令。如果特定裝置是 Google Nest Cam Indoor 或 Google Nest Cam Outdoor，則可在 Nest 應用程式或 Google Home 應用程式中使用。攝影機在 Nest 應用程式中使用時，則會使用 RTSP。攝影機開啟 Google Home 應用程式時，則會使用 WebRTC。	`array(string)` 值：["RTSP", "WEB_RTC"]

影片解析度 (maxVideoResolution)

欄位	說明	資料類型
`width`	圖片解析度上限。也可以做為下載網址中的查詢參數。	`int32` 示例：640
`height`	圖片解析度的最大高度。也可以做為下載網址中的查詢參數。	`int32` 示例：480

GET 要求和回應範例

要求

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

回應

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

指令

GenerateRtspStream

Nest Cam (舊版) Nest Hub Max Nest Doorbell (舊版)

要求權杖以存取 RTSP 直播網址。

RTSP 直播網址無法在用戶端之間共用。串流網址一次只能由一個用戶端使用。如果多位用戶端同時想透過同一部攝影機串流播放，則必須為每個用戶端分別傳送 RTSP 指令，且每個用戶端都必須使用各自的串流網址。

GenerateRtspStream 要求和回應

要求

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

回應

{
  "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 回應欄位

欄位	說明	資料類型
`streamUrls`	RTSP 直播網址對應圖。	`object`
`streamExtensionToken`	用於為 RTSP 直播活動擴充 `streamToken` 的權杖。	`string` 範例：「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
`streamToken`	用於存取 RTSP 直播的權杖。	`string` 範例：「g.0.streamingToken」
`expiresAt`	`streamExtensionToken` 和 `streamToken` 的到期時間，採用 RFC 3339 格式。	`string` 範例：「2018-01-04T18:30:00.000Z」

ExtendRtspStream

Nest Cam (舊版) Nest Hub Max Nest Doorbell (舊版)

在到期前索取新的 RTSP 直播網址存取權杖，藉此取代有效的 RTSP 存取權杖。這也可用來取代先前 ExtendedRtspStream 指令要求的有效 RTSP 權杖。

攝影機直播工作階段的時效只有 5 分鐘。如需延長直播的生命週期，請針對你產生的串流格式，使用 CameraLiveStream 特徵的適當擴充Format串流指令。

ExtendedRtspStream 要求和回應

要求

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

回應

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

ExtendedRtspStream 要求欄位

欄位	說明	資料類型
`streamExtensionToken`	這個權杖用於要求 RTSP 串流權杖的擴充功能。	`string` 範例：「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」

ExtendedRtspStream 回應欄位

欄位	說明	資料類型
`streamExtensionToken`	這個權杖可用於查看現有 RTSP 直播內容，以及要求擴充至串流權杖。	`string` 例如：「dGNUlTU2CjY5Y3VKaTZwR3o4Y1...」
`streamToken`	用於存取現有 RTSP 直播的新權杖。	`string` 範例：「g.0.newStreamingToken」
`expiresAt`	`streamExtensionToken` 和 `streamToken` 的到期時間，採用 RFC 3339 格式。	`string` 範例：「2018-01-04T18:30:00.000Z」

StopRtspStream

Nest Cam (舊版) Nest Hub Max Nest Doorbell (舊版)

撤銷有效的 RTSP 存取權杖，並停止與該存取權杖相關的 RTSP 直播。

StopRtspStream 要求與回應

要求

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

回應

{}

StopRtspStream 要求欄位

欄位	說明	資料類型
`streamExtensionToken`	用於讓現有 RTSP 直播活動失效的權杖。	`string` 範例：「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」

GenerateWebRtcStream

Nest Cam (舊版) Nest Cam (室內外兩用，電池版) Nest Cam (搭配泛光燈) Nest Cam Indoor (有線版) Nest Doorbell (電池版) Nest Doorbell (有線版)

為裝置產生 WebRTC 直播。

GenerateWebRtcStream 要求和回應

要求

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

回應

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

GenerateWebRtcStream 要求欄位

建議你參考網頁應用程式範例，瞭解如何成功發起直播。本範例產生的有效 offerSdp 符合 Nest 攝影機的所有 SDP 優惠限制。

Nest 攝影機的 SDP 優惠必須符合下列限制：

僅支援統一格式。不支援方案 B。
所有媒體線 (m=) 都必須顯示在優惠中，並且按照以下順序排列：
1. 音訊內容
2. 影片
3. 調度應用程式資源
支援 Trickle ICE，但並非必要。
音訊僅支援 Opus 轉碼器。
音訊設定必須設為 a=recvonly (僅供接收)。
優惠結尾必須是 \r\n 或 \n 的換行字元。

查看有效優惠的範例

未設定格式：

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

已設定格式：

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

欄位	說明	資料類型
`offerSdp`	SDP 優惠，專門用於顯示 WebRTC 直播內容的本機裝置。	`string` 範例：「`offerSdp`」

GenerateWebRtcStream 回應欄位

answerSdp 必須使用在收到回應後的 30 秒內產生直播，否則將失效。如果過期，請再次執行 GenerateWebRtcStream 指令以接收新的 answerSdp。

開啟直播活動的 WebRTC 頻道時，請務必建立資料管道和影片頻道。

欄位	說明	資料類型
`answerSdp`	SDP 答案，用於顯示 WebRTC 直播的本機裝置。	`string` 範例：「`answerSdp`」
`expiresAt`	WebRTC 直播存取存取的時間 (採用 RFC 3339 格式)。	`string` 範例：「2020-01-04T18:30:00.000Z」
`mediaSessionId`	所產生 WebRTC 直播活動的媒體工作階段 ID。	`string` 範例：「QW_yv1uYh-WRDT6K8ZFuVywm5v...」

ExtendWebRtcStream

Nest Cam (舊版) Nest Cam (室內外兩用，電池版) Nest Cam (搭配泛光燈) Nest Cam Indoor (有線版) Nest Doorbell (有線版) Wired

要求在過期前延長現有 WebRTC 直播串流的存取權。

WebRTC 串流只能延伸至接線式攝影機。當攝影機接上電源充電時，以電池供電的攝影機視為有線電源。如果攝影機以電池供電，系統會忽略擴充現有 WebRTC 串流的要求。

攝影機直播工作階段的時效只有 5 分鐘。如需延長直播的生命週期，請針對你產生的串流格式，使用 CameraLiveStream 特徵的適當擴充Format串流指令。

擴充 WebRtcStream 要求和回應

要求

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

回應

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

ExtendedWebRtcStream 要求欄位

欄位	說明	資料類型
`mediaSessionId`	要擴充 WebRTC 直播的媒體工作階段 ID。	`string` 範例：「QW_yv1uYh-WRDT6K8ZFuVywm5v...」

ExtendedWebRtcStream 回應欄位

欄位	說明	資料類型
`expiresAt`	存取 WebRTC 直播串流的新時間到期，採用 RFC 3339 格式。	`string` 範例：「2018-01-04T18:30:00.000Z」
`mediaSessionId`	已擴充 WebRTC 直播的媒體工作階段 ID。	`string` 範例：「QW_yv1uYh-WRDT6K8ZFuVywm5v...」

StopWebRtcStream

Nest Cam (舊版) Nest Cam (室內外兩用，電池版) Nest Cam (搭配泛光燈) Nest Cam Indoor (有線版) Nest Doorbell (電池版) Nest Doorbell (有線版)

將有效的 WebRTC 媒體工作階段失效，並停止與該工作階段相關的 WebRTC 直播串流。

StopWebRtcStream 要求和回應

要求

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

回應

{}

StopWebRtcStream 要求欄位

欄位	說明	資料類型
`mediaSessionId`	要停止的 WebRTC 直播媒體工作階段 ID。	`string` 範例：「QW_yv1uYh-WRDT6K8ZFuVywm5v...」

錯誤

系統可能會根據這項特徵傳回下列錯誤代碼：

錯誤訊息	RPC	疑難排解
門鈴不支援指令。	`FAILED_PRECONDITION`	WebRTC 串流無法延伸至電池供電的門鈴。如果需要觀看門鈴上的串流，而且觀看的時間超過初始工作階段長度，請停止現有的串流，並產生新的串流。
權限遭拒。	`PERMISSION_DENIED`	user 尚未在合作夥伴連線管理工具 (PCM) 中授予 developer適當的裝置層級權限，因此無法執行指令。產生 WebRTC 直播串流時，這項錯誤也可能表示 `offerSdp` 中的音訊設定不正確。

如需 API 錯誤代碼的完整清單，請參閱 API 錯誤代碼參考資料。