طرحواره CameraLiveStream

Nest Cam (قدیمی) Nest Cam (در فضای باز یا داخلی، باتری) Nest Cam با نورافکن Nest Cam (داخلی، سیمی) Nest Hub Max Nest Doorbell (قدیمی) Nest Doorbell (باتری) Nest Doorbell (سیمی)

sdm.devices.traits.CameraLiveStream

این ویژگی متعلق به هر دستگاهی است که از پخش زنده پشتیبانی می کند.

فیلدها

میدان توضیحات نوع داده
maxVideoResolution حداکثر وضوح پخش زنده ویدیو. VideoResolution
videoCodecs کدک های ویدیویی برای پخش زنده پشتیبانی می شوند. array(string)
مقدار: ["H264"]
audioCodecs کدک های صوتی برای پخش زنده پشتیبانی می شوند. array(string)
مقدار: ["AAC"]
supportedProtocols پروتکل های استریم پشتیبانی شده توسط دستگاه. مقدار این فیلد نشان می دهد که کدام دستورات برای دستگاه پشتیبانی می شوند. به عنوان مثال، اگر این فیلد حاوی WEB_RTC باشد، فقط دستورات WEB_RTC پشتیبانی می شوند. array(string)
مقدار: ["RTSP"، "WEB_RTC"]

وضوح تصویر (maxVideoResolution)

میدان توضیحات نوع داده
width حداکثر عرض وضوح تصویر همچنین ممکن است به عنوان پارامتر پرس و جو در URL دانلود استفاده شود. int32
مثال: 640
height حداکثر ارتفاع وضوح تصویر همچنین ممکن است به عنوان پارامتر پرس و جو در URL دانلود استفاده شود. 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 (قدیمی)

برای دسترسی به URL پخش زنده RTSP یک نشانه درخواست کنید.

URL های پخش زنده RTSP را نمی توان بین مشتریان به اشتراک گذاشت. URL استریم فقط می تواند توسط یک مشتری در یک زمان استفاده شود. اگر چندین مشتری بخواهند همزمان از یک دوربین استریم کنند، دستورات RTSP باید برای هر کلاینت جداگانه ارسال شود و هر کلاینت جداگانه باید از URL استریم خود استفاده کند.

درخواست و پاسخ 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 نقشه URL های پخش زنده RTSP. object
streamExtensionToken رمزی برای استفاده برای گسترش streamToken برای یک جریان زنده RTSP. 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 قبل از انقضا، یک نشانه دسترسی مستقیم به URL جاری‌سازی زنده RTSP درخواست کنید. این همچنین برای جایگزینی یک نشانه معتبر RTSP از یک درخواست فرمان قبلی ExtendRtspStream استفاده می شود.

جلسات پخش زنده دوربین فقط 5 دقیقه معتبر است. اگر می‌خواهید طول عمر پخش زنده را افزایش دهید، از دستور مناسب Extend Format Stream استفاده کنید. CameraLiveStream ویژگی برای قالب جریانی که ایجاد کردید.

درخواست و پاسخ ExtendRtspStream

درخواست کنید

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"
  }
}

فیلدهای درخواست ExtendRtspStream

میدان توضیحات نوع داده
streamExtensionToken رمزی برای استفاده برای درخواست افزونه به رمز پخش جریانی RTSP. string
مثال: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."

فیلدهای پاسخ ExtendRtspStream

میدان توضیحات نوع داده
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..."

WebRtcStream را ایجاد کنید

Nest Cam (قدیمی) Nest Cam (در فضای باز یا داخلی، باتری) Nest Cam با نورافکن Nest Cam (داخلی، با سیم) Nest Doorbell (باتری) Nest Doorbell (سیمی)

یک جریان زنده WebRTC برای یک دستگاه ایجاد کنید.

درخواست و پاسخ WebRtcStream را ایجاد کنید

درخواست کنید

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" : "6YuWyq9p_phfJreS-alPwYbEoP..."
  }
}

ایجاد فیلدهای درخواست WebRtcStream

توصیه می کنیم از نمونه برنامه کاربردی وب برای یادگیری نحوه ایجاد یک جریان زنده موفق استفاده کنید. این نمونه یک offerSdp معتبر ایجاد می‌کند که با تمام محدودیت‌های پیشنهاد SDP برای دوربین‌های Nest مطابقت دارد.

پیشنهاد SDP برای دوربین‌های Nest باید دارای محدودیت‌های زیر باشد:

  • فقط فرمت Unified پشتیبانی می شود. طرح 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 "

ایجاد فیلدهای پاسخ WebRtcStream

answerSdp باید برای تولید جریان زنده در عرض 30 ثانیه پس از دریافت پاسخ استفاده شود، در غیر این صورت منقضی می شود. اگر منقضی شد، دستور GenerateWebRtcStream را دوباره اجرا کنید تا یک answerSdp جدید دریافت کنید.

هنگام باز کردن کانال های WebRTC برای پخش زنده، مطمئن شوید که یک کانال داده و همچنین یک کانال ویدیویی ایجاد کنید.

میدان توضیحات نوع داده
answerSdp یک پاسخ SDP برای استفاده با دستگاه محلی که جریان زنده WebRTC را نمایش می دهد. string
مثال: " answerSdp "
expiresAt زمانی که دسترسی به جریان زنده WebRTC در قالب RFC 3339 منقضی می‌شود. string
مثال: "2020-01-04T18:30:00.000Z"
mediaSessionId شناسه جلسه رسانه پخش زنده WebRTC ایجاد شده. string
مثال: "6YuWyq9p_phfJreS-alPwYbEoP..."

ExtendWebRtcStream

Nest Cam (قدیمی) Nest Cam (در فضای باز یا داخلی، باتری) Nest Cam با نورافکن Nest Cam (داخلی، با سیم) Nest Doorbell (سیمی) سیمی

درخواست کنید که دسترسی به یک جریان زنده WebRTC قبل از منقضی شدن آن تمدید شود.

پخش جریانی WebRTC را فقط می‌توان در دوربین‌های سیمی گسترش داد. دوربینی که با باتری کار می کند، در حالی که برای شارژ به برق وصل است، سیمی در نظر گرفته می شود. اگر دوربین از باتری استفاده می کند، درخواست برای گسترش جریان WebRTC فعال نادیده گرفته می شود.

جلسات پخش زنده دوربین فقط 5 دقیقه معتبر است. اگر می‌خواهید طول عمر پخش زنده را افزایش دهید، از دستور مناسب Extend Format Stream استفاده کنید. CameraLiveStream ویژگی برای قالب جریانی که ایجاد کردید.

درخواست و پاسخ ExtendWebRtcStream

درخواست کنید

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

پاسخ

{
  "results" : {
    "expiresAt" : "2018-01-04T18:30:00.000Z",
    "mediaSessionId" : "6YuWyq9p_phfJreS-alPwYbEoP..."
  }
}

ExtendWebRtcStream فیلدهای درخواست

میدان توضیحات نوع داده
mediaSessionId شناسه جلسه رسانه جریان زنده WebRTC تمدید می شود. string
مثال: "6YuWyq9p_phfJreS-alPwYbEoP..."

ExtendWebRtcStream فیلدهای پاسخ

میدان توضیحات نوع داده
expiresAt زمان جدیدی که در آن دسترسی به جریان زنده WebRTC در قالب RFC 3339 منقضی می‌شود. string
مثال: "2018-01-04T18:30:00.000Z"
mediaSessionId شناسه جلسه رسانه جریان زنده WebRTC که تمدید شد. string
مثال: "6YuWyq9p_phfJreS-alPwYbEoP..."

StopWebRtcStream

Nest Cam (قدیمی) Nest Cam (در فضای باز یا داخلی، باتری) Nest Cam با نورافکن Nest Cam (داخلی، با سیم) Nest Doorbell (باتری) Nest Doorbell (سیمی)

یک جلسه رسانه WebRTC معتبر را باطل می کند و جریان زنده WebRTC مرتبط با آن جلسه را متوقف می کند.

درخواست و پاسخ StopWebRtcStream

درخواست کنید

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

پاسخ

{}

فیلدهای درخواست StopWebRtcStream

میدان توضیحات نوع داده
mediaSessionId شناسه جلسه رسانه جریان زنده WebRTC متوقف شود. string
مثال: "6YuWyq9p_phfJreS-alPwYbEoP..."

خطاها

کد(های) خطای زیر ممکن است در رابطه با این ویژگی برگردانده شوند:

پیغام خطا RPC عیب یابی
دوربین برای پخش در دسترس نیست. FAILED_PRECONDITION دوربین یا آفلاین است یا به دلیل مشکل فنی برای پخش در دسترس نیست.
فرمان برای زنگ در پشتیبانی نمی شود. FAILED_PRECONDITION پخش جریانی WebRTC را نمی‌توان در زنگ‌های درب باطری گسترش داد. اگر جریانی در زنگ در باید فراتر از طول جلسه اولیه مشاهده شود، جریان موجود را متوقف کنید و یک جریان جدید ایجاد کنید.
اجازه رد شد. PERMISSION_DENIED را user اعطا نکرده است developerمجوزهای مناسب در سطح دستگاه در Partner Connections Manager (PCM) مورد نیاز برای اجرای یک فرمان.

هنگام ایجاد یک جریان زنده WebRTC، این خطا همچنین می تواند به این معنی باشد که تنظیمات صوتی در offerSdp نادرست است.

برای لیست کامل کدهای خطای API به مرجع کد خطای API مراجعه کنید.