Skip to content

membraneframework/ex_sdp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ExSDP

Hex.pm API Docs CircleCI

Parser and serializer for Session Description Protocol. Based on RFC4566

Installation

The package can be installed by adding ex_sdp to your list of dependencies in mix.exs:

def deps do
  [
    {:ex_sdp, "~> 1.1"}
  ]
end

Usage

Parser

Parser parses string with \r\n terminated lines. (although it will also accept records terminated with a single newline character)

"""
v=0
o=jdoe 2890844526 2890842807 IN IP4 10.47.16.5
s=Very fancy session name
i=A Seminar on the session description protocol
u=http://www.example.com/seminars/sdp.pdf
[email protected] (Jane Doe)
p=111 111 111
c=IN IP4 224.2.17.12/127
b=AS:256
t=2873397496 2873404696
r=604800 3600 0 90000
r=7d 1h 0 25h
z=2882844526 -1h 2898848070 0
k=clear:key
a=recvonly
a=key:value
m=audio 49170 RTP/AVP 0
i=Sample media title
k=prompt
m=video 51372 RTP/AVP 99
a=rtpmap:99 h263-1998/90000
"""
|> String.replace("\n", "\r\n")
|> ExSDP.parse()

# =>
{:ok,
 %ExSDP{
   attributes: [{"key", "value"}, :recvonly],
   bandwidth: [%ExSDP.Bandwidth{bandwidth: 256, type: :AS}],
   connection_data: %ExSDP.ConnectionData{
     address: {224, 2, 17, 12},
     address_count: nil,
     network_type: "IN",
     ttl: 127
   },
   email: "[email protected] (Jane Doe)",
   encryption: %ExSDP.Encryption{key: "key", method: :clear},
   media: [
     %ExSDP.Media{
       attributes: [],
       bandwidth: [%ExSDP.Bandwidth{bandwidth: 256, type: :AS}],
       connection_data: %ExSDP.ConnectionData{
         address: {224, 2, 17, 12},
         address_count: nil,
         network_type: "IN",
         ttl: 127
       },
       encryption: %ExSDP.Encryption{key: nil, method: :prompt},
       fmt: [0],
       port: 49170,
       port_count: 1,
       protocol: "RTP/AVP",
       title: "Sample media title",
       type: :audio
     },
     %ExSDP.Media{
       attributes: [
         %ExSDP.Attribute.RTPMapping{
           clock_rate: 90000,
           encoding: "h263-1998",
           params: nil,
           payload_type: 99
         }
       ],
       bandwidth: [%ExSDP.Bandwidth{bandwidth: 256, type: :AS}],
       connection_data: %ExSDP.ConnectionData{
         address: {224, 2, 17, 12},
         address_count: nil,
         network_type: "IN",
         ttl: 127
       },
       encryption: %ExSDP.Encryption{key: "key", method: :clear},
       fmt: 'c',
       port: 51372,
       port_count: 1,
       protocol: "RTP/AVP",
       title: nil,
       type: :video
     }
   ],
   origin: %ExSDP.Origin{
     address: {10, 47, 16, 5},
     network_type: "IN",
     session_id: 2890844526,
     session_version: 2890842807,
     username: "jdoe"
   },
   phone_number: "111 111 111",
   session_information: "A Seminar on the session description protocol",
   session_name: "Very fancy session name",
   time_repeats: [
     %ExSDP.RepeatTimes{
       active_duration: 3600,
       offsets: [0, 90000],
       repeat_interval: 604800
     },
     %ExSDP.RepeatTimes{
       active_duration: 3600,
       offsets: [0, 90000],
       repeat_interval: 604800
     }
   ],
   time_zones_adjustments: %ExSDP.Timezone{
     corrections: [
       %ExSDP.Timezone.Correction{adjustment_time: 2882844526, offset: -1},
       %ExSDP.Timezone.Correction{adjustment_time: 2898848070, offset: 0}
     ]
   },
   timing: %ExSDP.Timing{start_time: 2873397496, stop_time: 2873404696},
   uri: "http://www.example.com/seminars/sdp.pdf",
   version: 0
 }}

Serializer

Serializer serializes ExSDP struct to a string with \r\n terminated lines.

%ExSDP{
   attributes: [{"key", "value"}, :recvonly],
   bandwidth: [%ExSDP.Bandwidth{bandwidth: 256, type: :AS}],
   connection_data: %ExSDP.ConnectionData{
     address: {224, 2, 17, 12},
     network_type: "IN",
     ttl: 127
   },
   email: "[email protected] (Jane Doe)",
   encryption: %ExSDP.Encryption{key: "key", method: :clear},
   media: [
     %ExSDP.Media{
       attributes: [],
       bandwidth: [%ExSDP.Bandwidth{bandwidth: 256, type: :AS}],
       connection_data: %ExSDP.ConnectionData{
         address: {224, 2, 17, 12},
         network_type: "IN",
         ttl: 127
       },
       encryption: %ExSDP.Encryption{method: :prompt},
       fmt: [0],
       port: 49170,
       port_count: 1,
       protocol: "RTP/AVP",
       title: "Sample media title",
       type: :audio
     },
     %ExSDP.Media{
       attributes: [
         %ExSDP.Attribute.RTPMapping{
           clock_rate: 90000,
           encoding: "h263-1998",
           payload_type: 99
         }
       ],
       bandwidth: [%ExSDP.Bandwidth{bandwidth: 256, type: :AS}],
       connection_data: %ExSDP.ConnectionData{
         address: {224, 2, 17, 12},
         network_type: "IN",
         ttl: 127
       },
       encryption: %ExSDP.Encryption{key: "key", method: :clear},
       fmt: 'c',
       port: 51372,
       port_count: 1,
       protocol: "RTP/AVP",
       type: :video
     }
   ],
   origin: %ExSDP.Origin{
     address: {10, 47, 16, 5},
     network_type: "IN",
     session_id: 2890844526,
     session_version: 2890842807,
     username: "jdoe"
   },
   phone_number: "111 111 111",
   session_information: "A Seminar on the session description protocol",
   session_name: "Very fancy session name",
   time_repeats: [
     %ExSDP.RepeatTimes{
       active_duration: 3600,
       offsets: [0, 90000],
       repeat_interval: 604800
     },
     %ExSDP.RepeatTimes{
       active_duration: 3600,
       offsets: [0, 90000],
       repeat_interval: 604800
     }
   ],
   time_zones_adjustments: %ExSDP.Timezone{
     corrections: [
       %ExSDP.Timezone.Correction{adjustment_time: 2882844526, offset: -1},
       %ExSDP.Timezone.Correction{adjustment_time: 2898848070, offset: 0}
     ]
   },
   timing: %ExSDP.Timing{start_time: 2873397496, stop_time: 2873404696},
   uri: "http://www.example.com/seminars/sdp.pdf",
   version: 0
}
|> to_string()

# =>
"""
v=0
o=jdoe 2890844526 2890842807 IN IP4 10.47.16.5
s=Very fancy session name
i=A Seminar on the session description protocol
u=http://www.example.com/seminars/sdp.pdf
[email protected] (Jane Doe)
p=111 111 111
c=IN IP4 224.2.17.12/127
b=AS:256
t=2873397496 2873404696
r=604800 3600 0 90000
r=604800 3600 0 90000
z=2882844526 -1h 2898848070 0
k=clear:key
a=key:value
a=recvonly
m=audio 49170 RTP/AVP 0
i=Sample media title
c=IN IP4 224.2.17.12/127
b=AS:256
k=prompt
m=video 51372 RTP/AVP 99
c=IN IP4 224.2.17.12/127
b=AS:256
k=clear:key
a=rtpmap:99 h263-1998/90000
"""

Copyright and License

Copyright 2020, Software Mansion

Software Mansion

Licensed under the Apache License, Version 2.0