Get Live RTSP

Get a RTSP formated live stream of a specific Accessory ID.

Retrieve a RFC 2326 (RTSP 1.0) URI to view an Accessory live stream. This call will return a single use, time limited RTSP URI that must be invoked within 30 seconds. The RTSP URI must be connected to via TLS, and only supports sending media with TCP embedded interleave mode. The RTSP endpoint supports OPTIONS, DESCRIBE, SETUP, PLAY and TEARDOWN. The video stream is H.264 and the audio is 32Khz AAC. If the stream drops, you must call this again to get a new URI.

🚧

Note

Some media players require RTSP over TLS to use rtsps:// as the scheme field. If your player is one of these, just string replace rtsp:// with rtsps:// in the response to this call.

Permissions

Requires a Permissions scope of: circle:live

Response Body

Name

Type

Description

rtsp_uri

string

A single-use RTSP 1.0 URI for the Live view of the requested Accessory Id. Must be connected to within 30 seconds.

# 1. Place initial request to API server to get RTSP URI
GET /api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp
  
# JSON Response comes
{
    "rtsp_uri": "rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz/stream.mp4"
}
 
# 2. RTSP Direct Connection is started over TLS to node-i-f81d243f.video.logi.com:443
  
# 3. RTSP OPTIONS
C->S: OPTIONS rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz/stream.mp4 RTSP/1.0
      CSeq: 1
 
S->C: RTSP/1.0 200 OK
      CSeq: 1
      Session: 12345678
      Public: DESCRIBE, SETUP, TEARDOWN, PAUSE
 
# 4. RTSP DESCRIBE
C->S: DESCRIBE rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz/stream.mp4 RTSP/1.0
      CSeq: 2
 
S->C: RTSP/1.0 200 OK
      CSeq: 2
      content-type:application/sdp
      Content-Base:rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz/
      Session: 12345678
  
      sdp=v=0
      o=- 8b7824ade96f3d4c 1 IN IP4 node-i-f81d243f.video.logi.com
      s=Logitech Circle
      i=Logitech Circle
      t=0 0
      a=tool:Logitech Circle 1.46.0-149-g26fc55d
      a=type:broadcast
      a=range:npt=0-
      a=x-qt-text-nam:Logitech Circle
      a=x-qt-text-inf:Logitech Circle
      m=video 0 RTP/AVP 96
      c=IN IP4 0.0.0.0
      b=AS:1000
      b=RS:0
      b=RR:0
      b=TIAS:100000
      a=rtpmap:96 H264/90000
      a=fmtp:96 packetization-mode=2;profile-level-id=4D001F;sprop-parameter-sets=Z00AH5pkAoAt//+CsIKwNwEBAUAAAPoAAB1MOhgBMUABMTLvLjQwAmKAAmJl3lwo,aO48gA==
      a=sendonly
      a=control:video-track
      m=audio 0 RTP/AVP 97
      c=IN IP4 0.0.0.0
      b=AS:64
      b=RS:0
      b=RR:0
      b=TIAS:64000
      a=rtpmap:97 mpeg4-generic/32000/1
      a=fmtp:97 streamtype=5;profile-level-id=1;mode=AAC-hbr;sizelength=13;indexlength=3;indexdeltalength=3;config=1288
      a=sendonly
      a=control:audio-track
  
# 5. RTSP SETUP video-track
C->S: SETUP rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz/video-track RTSP/1.0
      CSeq: 3
      Transport: RTP/AVP/TCP;interleaved=0-1
 
S->C: RTSP/1.0 200 OK
      CSeq: 3
      Session: 12345678
      Transport:RTP/AVP/TCP;unicast;interleaved=0-1;ssrc=00102988
  
# 6. RTSP SETUP audio-track
C->S: SETUP rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz/audio-track RTSP/1.0
      CSeq: 4
      Transport: RTP/AVP/TCP;interleaved=2-3
 
S->C: RTSP/1.0 200 OK
      CSeq: 4
      Session: 12345678
      Transport:RTP/AVP/TCP;unicast;interleaved=2-3;ssrc=A1389410
 
 
# 7. RTSP PLAY
C->S: PLAY rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz RTSP/1.0
      CSeq: 5
      Session: 12345678
 
S->C: RTSP/1.0 200 OK
      CSeq: 5
      Session: 12345678
 
S->C: $\000{2 byte length}{"length" bytes data, w/RTP header}
S->C: $\000{2 byte length}{"length" bytes data, w/RTP header}
S->C: $\001{2 byte length}{"length" bytes  RTCP packet}
  
  
# 8. RTSP TEARDOWN
C->S: TEARDOWN rtsp://node-i-f81d243f.video.logi.com:443/api/accessories/70e3e6f9-70c3-45b2-62e4-ace3d027988a/live/rtsp/1496179861/ASDAFASDADDASavjaYTEAvmakgAScassklapwmbnz RTSP/1.0
      CSeq: 6
      Session: 12345678
 
S->C: RTSP/1.0 200 OK
      CSeq: 6
      Session: 12345678
Language
Authentication
OAuth2