├── src └── main │ ├── js │ └── .gitignore │ └── pegjs │ └── SdpParser.pegjs ├── .travis.yml ├── spec ├── support │ └── jasmine.json └── SdpParserSpec.js ├── dev.md ├── bower.json ├── .gitignore ├── package.json ├── LICENSE └── README.md /src/main/js/.gitignore: -------------------------------------------------------------------------------- 1 | SdpParser.js -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | language: node_js 2 | node_js: 3 | - stable 4 | -------------------------------------------------------------------------------- /spec/support/jasmine.json: -------------------------------------------------------------------------------- 1 | { 2 | "spec_dir": "spec", 3 | "spec_files": [ 4 | "**/*[sS]pec.js" 5 | ], 6 | "helpers": [ 7 | "helpers/**/*.js" 8 | ] 9 | } 10 | -------------------------------------------------------------------------------- /dev.md: -------------------------------------------------------------------------------- 1 | # Development 2 | The SDPParser was developed using [Peg.js](http://pegjs.org), a parser generator for JavaScript. The [grammar syntax](http://pegjs.org/documentation) is very easy to learn and use. There is also an [online development tool](http://pegjs.org/online). 3 | 4 | ## Testing 5 | The testing is done using Jasmine. To run the tests just run `npm test` or `jasmine`. -------------------------------------------------------------------------------- /bower.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "sdpparser", 3 | "version": "0.0.2", 4 | "description": "SDP Parser (RFC 4566)", 5 | "author": "Adrian Ber", 6 | "license": "MIT", 7 | "homepage": "https://github.com/beradrian/sdpparser", 8 | "main": "src/main/js/SdpParser.js", 9 | "ignore": [ 10 | "**/.*", 11 | "node_modules", 12 | "docs", 13 | "Gruntfile.js", 14 | "index.html", 15 | "package.json" 16 | ], 17 | "dependencies": { 18 | "jscommon": ">=0.0.2" 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Logs 2 | logs 3 | *.log 4 | 5 | # Runtime data 6 | pids 7 | *.pid 8 | *.seed 9 | 10 | # Directory for instrumented libs generated by jscoverage/JSCover 11 | lib-cov 12 | 13 | # Coverage directory used by tools like istanbul 14 | coverage 15 | 16 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files) 17 | .grunt 18 | 19 | # node-waf configuration 20 | .lock-wscript 21 | 22 | # Compiled binary addons (http://nodejs.org/api/addons.html) 23 | build/Release 24 | 25 | # Dependency directory 26 | # https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git 27 | node_modules 28 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "sdpparser" 3 | , "version": "0.0.6" 4 | , "description": "SdpParser - JavaScript parser for SDP (RFC 4566)" 5 | , "author": { 6 | "name": "Adrian Ber", 7 | "email": "beradrian@yahoo.com" 8 | } 9 | , "license": "MIT" 10 | , "repository" : { 11 | "type" : "git" 12 | , "url" : "https://github.com/beradrian/sdpparser.git" 13 | } 14 | , "main": "src/main/js/SdpParser.js" 15 | , "dependencies": { 16 | "jscommon": "beradrian/jscommon" 17 | } 18 | , "devDependencies" : { 19 | "pegjs": "latest" 20 | , "jasmine": ">=2.3.1" 21 | } 22 | , "scripts": { 23 | "pegjs": "node_modules/.bin/pegjs -o src/main/js/SdpParser.js src/main/pegjs/SdpParser.pegjs" 24 | , "test": "npm run pegjs & jasmine" 25 | , "postinstall": "npm run pegjs" 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | The MIT License (MIT) 2 | 3 | Copyright (c) 2015 Adrian Ber 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | 23 | -------------------------------------------------------------------------------- /spec/SdpParserSpec.js: -------------------------------------------------------------------------------- 1 | var SdpParser = require("../src/main/js/SdpParser.js"); 2 | 3 | describe("SdpParser", function() { 4 | it("should parse version", function() { 5 | var sdp = SdpParser.parse("v=0"); 6 | expect(sdp.version).toBe(0); 7 | expect(SdpParser.format(sdp)).toEqual("v=0\r\n"); 8 | sdp = SdpParser.parse("v=0\r\n"); 9 | expect(sdp.version).toBe(0); 10 | expect(SdpParser.format(sdp)).toEqual("v=0\r\n"); 11 | }); 12 | 13 | it("should parse repeat", function() { 14 | var sdp = SdpParser.parse("v=0\r\nr=1d 30m 100 2h"); 15 | expect(sdp.version).toBe(0); 16 | expect(sdp.repeat).toBeDefined(); 17 | expect(sdp.repeat.interval).toEqual(86400); 18 | expect(sdp.repeat.activeDuration).toEqual(1800); 19 | expect(sdp.repeat.offsets).toEqual([100, 7200]); 20 | }); 21 | 22 | it("should parse repeat without offsets", function() { 23 | var sdp = SdpParser.parse("v=0\r\nr=1d 30m"); 24 | expect(sdp.version).toBe(0); 25 | expect(sdp.repeat).toBeDefined(); 26 | expect(sdp.repeat.interval).toEqual(86400); 27 | expect(sdp.repeat.activeDuration).toEqual(1800); 28 | expect(sdp.repeat.offsets).toEqual([]); 29 | }); 30 | 31 | it("should format compact repeat", function() { 32 | var sdp = SdpParser.parse("v=0\r\nr=1d 1800 100 3600"); 33 | expect(sdp.version).toBe(0); 34 | expect(sdp.repeat).toBeDefined(); 35 | expect(sdp.repeat.interval).toEqual(86400); 36 | expect(sdp.repeat.activeDuration).toEqual(1800); 37 | expect(sdp.repeat.offsets).toEqual([100, 3600]); 38 | var s = SdpParser.format(sdp); 39 | expect(s).toEqual("v=0\r\nr=1d 30m 100 1h\r\n"); 40 | }); 41 | 42 | it("should parse timezones", function() { 43 | var sdp = SdpParser.parse("v=0\r\nz=2882844526 -1h 2898848070 0 2898850010 200s"); 44 | expect(sdp.version).toBe(0); 45 | expect(sdp.timezones[0].adjustment).toEqual(2882844526); 46 | expect(sdp.timezones[0].offset).toEqual(-3600); 47 | expect(sdp.timezones[1].adjustment).toEqual(2898848070); 48 | expect(sdp.timezones[1].offset).toEqual(0); 49 | expect(sdp.timezones[2].adjustment).toEqual(2898850010); 50 | expect(sdp.timezones[2].offset).toEqual(200); 51 | var s = SdpParser.format(sdp); 52 | expect(s).toEqual("v=0\r\nz=2882844526 -1h 2898848070 0 2898850010 200\r\n"); 53 | }); 54 | 55 | it("should parse encryption keys", function() { 56 | var sdp = SdpParser.parse("v=0\r\nk=prompt\r\nk=clear:123"); 57 | expect(sdp.version).toBe(0); 58 | expect(sdp.encryptionKey[0].method).toEqual("prompt"); 59 | expect(sdp.encryptionKey[0].key).toBe(undefined); 60 | expect(sdp.encryptionKey[1].method).toEqual("clear"); 61 | expect(sdp.encryptionKey[1].key).toEqual("123"); 62 | var s = SdpParser.format(sdp); 63 | expect(s).toEqual("v=0\r\nk=prompt\r\nk=clear:123\r\n"); 64 | }); 65 | 66 | it("should parse attribute", function() { 67 | var sdp = SdpParser.parse("v=0\r\na=group:BUNDLE audio video\r\n"); 68 | expect(sdp.version).toBe(0); 69 | expect(sdp.group).toEqual("BUNDLE audio video"); 70 | expect(SdpParser.format(sdp)).toEqual("v=0\r\na=group:BUNDLE audio video\r\n"); 71 | }); 72 | 73 | it("should aggregate", function() { 74 | var sdp = SdpParser.parse("v=0\r\na=ssrc:3140675822 mslabel:8pjbfua\r\na=ssrc:3140675822 label:40fff5e6-d618-4b7a\r\n"); 75 | expect(sdp.version).toBe(0); 76 | expect(sdp.ssrc.length).toBe(2); 77 | expect(sdp.ssrc[0]).toEqual("3140675822 mslabel:8pjbfua"); 78 | }); 79 | 80 | it("should parse media", function() { 81 | var sdp = SdpParser.parse("v=0\r\nm=audio 9 UDP/TLS/RTP/SAVPF 111 103 104"); 82 | expect(sdp.version).toBe(0); 83 | expect(sdp.media.length).toBe(1); 84 | expect(sdp.media[0].type).toEqual("audio"); 85 | expect(sdp.media[0].payloads.length).toBe(3); 86 | }); 87 | 88 | it("should parse media and payloads", function() { 89 | var sdp = SdpParser.parse("v=0\r\nm=audio 9 UDP/TLS/RTP/SAVPF 111 103 104\r\nc=IN IP4 0.0.0.0\r\na=rtpmap:111 opus/48000/2\r\na=fmtp:111 minptime=10; useinbandfec=1\r\na=rtpmap:103 ISAC/16000\r\na=fmtp:103 foo=1\r\n\r\na=rtpmap:104 ISAC/32000\r\n"); 90 | expect(sdp.version).toBe(0); 91 | expect(sdp.media.length).toBe(1); 92 | expect(sdp.media[0].payloads[0].id).toBe(111); 93 | expect(sdp.media[0].payloads[0].rtp.codec).toBe("opus"); 94 | expect(SdpParser.format(sdp)).toMatch(/v=0.*/g); 95 | }); 96 | 97 | it("should parse real life example", function() { 98 | var sdp = SdpParser.parse("v=0\r\no=- 718035783275703419 2 IN IP4 127.0.0.1\r\ns=-\r\nt=0 0\r\na=group:BUNDLE audio video\r\na=msid-semantic: WMS 8pjbfuaudqpe5s3uA\r\nm=audio 9 UDP/TLS/RTP/SAVPF 111 103 104 9 0 8 106 105 13 126\r\nc=IN IP4 0.0.0.0\r\na=rtcp:9 IN IP4 0.0.0.0\r\na=ice-ufrag:Lw5NgNWQ\r\na=ice-pwd:qfy9wvi9J3g7G\r\na=fingerprint:sha-256 36:B6:83:67:03:BB:\r\na=setup:active\r\na=mid:audio\r\na=extmap:1 urn:ietf:params:rtp-hdrext:ssrc-audio-level\r\na=extmap:3 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time\r\na=sendrecv\r\na=rtcp-mux\r\na=rtpmap:111 opus/48000/2\r\na=fmtp:111 minptime=10; useinbandfec=1\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:126 telephone-event/8000\r\na=maxptime:60\r\na=ssrc:3140675822 cname:STNh4RdVs\r\na=ssrc:3140675822 msid:8pjbfuaudq\r\na=ssrc:3140675822 mslabel:8pjbfua\r\na=ssrc:3140675822 label:40fff5e6-d618-4b7a\r\n"); 99 | expect(sdp.version).toBe(0); 100 | expect(sdp.media.length).toBe(1); 101 | expect(sdp.media[0].payloads[0].id).toBe(111); 102 | expect(sdp.media[0].payloads[0].rtp.codec).toBe("opus"); 103 | var sdpText = SdpParser.format(sdp); 104 | expect(sdpText).toMatch(/v=0.*/g); 105 | expect(sdpText).not.toMatch(/\[object Object\]/g); 106 | }); 107 | 108 | }); -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ![Bower](https://img.shields.io/bower/v/sdpparser.svg) [![NPM](https://img.shields.io/npm/v/sdpparser.svg)](https://www.npmjs.com/package/sdpparser) ![License](https://img.shields.io/npm/l/sdpparser.svg) 2 | [![Build Status](https://travis-ci.org/beradrian/sdpparser.png)](https://travis-ci.org/beradrian/sdpparser) 3 | 4 | [![NPM](https://nodei.co/npm/sdpparser.png)](https://nodei.co/npm/sdpparser/) 5 | 6 | # SdpParser 7 | A parser for SDP partially compliant with [RFC 4566](https://tools.ietf.org/html/rfc4566#page-7). More about [Sesssion Description Protocol](http://en.wikipedia.org/wiki/Session_Description_Protocol). Another interesting RFC is the [RFC draft for Opus codec](https://tools.ietf.org/html/draft-spittka-payload-rtp-opus-03). This parser was written to be used in conjuction with WebRTC. This way you can easily modify settings like codec parameters. 8 | 9 | ## Installation 10 | Using 11 | - *npm*: `npm install sdpparser`. See below an example using `require`. 12 | - directly: download the archive from releases and include `SdpParser.js` and `jscommon.js` 13 | 14 | This can be used either from a browser or on the server side. 15 | 16 | ## Usage 17 | 18 | var SdpParser = require("SdpParser"); 19 | var filterSdp = function(sdpText) { 20 | var sdp = SdpParser.parse(sdpText); 21 | // ... do your changes to the sdp object ... 22 | sdpText = SdpParser.format(sdp); 23 | return sdpText; 24 | } 25 | 26 | peerConnection.createOffer(function(sessionDescription) { 27 | sessionDescription.sdp = filterSdp(sessionDescription.sdp); 28 | peerConnection.setLocalDescription(sessionDescription); 29 | }); 30 | 31 | 32 | ## Example 33 | Given the following SDP 34 | 35 | v=0 36 | o=- 718035783275703419 2 IN IP4 127.0.0.1 37 | s=- 38 | t=0 0 39 | a=group:BUNDLE audio video 40 | a=msid-semantic: WMS 8pjbfuaudqpe5s3uA 41 | m=audio 9 UDP/TLS/RTP/SAVPF 111 103 104 9 0 8 106 105 13 126 42 | c=IN IP4 0.0.0.0 43 | a=rtcp:9 IN IP4 0.0.0.0 44 | a=ice-ufrag:Lw5NgNWQ 45 | a=ice-pwd:qfy9wvi9J3g7G 46 | a=fingerprint:sha-256 36:B6:83:67:03:BB: 47 | a=setup:active 48 | a=mid:audio 49 | a=extmap:1 urn:ietf:params:rtp-hdrext:ssrc-audio-level 50 | a=extmap:3 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time 51 | a=sendrecv 52 | a=rtcp-mux 53 | a=rtpmap:111 opus/48000/2 54 | a=fmtp:111 minptime=10; useinbandfec=1 55 | a=rtpmap:103 ISAC/16000 56 | a=rtpmap:104 ISAC/32000 57 | a=rtpmap:9 G722/8000 58 | a=rtpmap:0 PCMU/8000 59 | a=rtpmap:8 PCMA/8000 60 | a=rtpmap:106 CN/32000 61 | a=rtpmap:105 CN/16000 62 | a=rtpmap:13 CN/8000 63 | a=rtpmap:126 telephone-event/8000 64 | a=maxptime:60 65 | a=ssrc:3140675822 cname:STNh4RdVs 66 | a=ssrc:3140675822 msid:8pjbfuaudq 67 | a=ssrc:3140675822 mslabel:8pjbfua 68 | a=ssrc:3140675822 label:40fff5e6-d618-4b7a 69 | 70 | the parsed JSON object will be 71 | 72 | { 73 | "version": 0, 74 | "origin": { 75 | "username": "-", 76 | "sessionId": "718035783275703419", 77 | "sessionVersion": 2, 78 | "networkType": "IN", 79 | "addressType": "IP4", 80 | "unicastAddress": "127.0.0.1" 81 | }, 82 | "sessionName": "-", 83 | "timing": { 84 | "start":0, 85 | "stop":0 86 | }, 87 | "group": "BUNDLE audio video", 88 | "msid-semantic": " WMS 8pjbfuaudqpe5s3uA", 89 | "media": [ 90 | { 91 | "type": "audio", 92 | "port": 9, 93 | "protocol": "UDP/TLS/RTP/SAVPF", 94 | "payloads": [ 95 | { 96 | "id":111, 97 | "rtp": { 98 | "codec": "opus", 99 | "rate": 48000, 100 | "codecParams": 2 101 | }, 102 | "fmtp": { 103 | "params": { 104 | "minptime":10, 105 | "useinbandfec":1 106 | } 107 | } 108 | }, 109 | { 110 | "id":103, 111 | "rtp": { 112 | "codec": "ISAC", 113 | "rate":16000 114 | } 115 | }, 116 | { 117 | "id":104, 118 | "rtp": { 119 | "codec": "ISAC", 120 | "rate":32000 121 | } 122 | }, 123 | { 124 | "id":9, 125 | "rtp": { 126 | "codec": "G722", 127 | "rate":8000 128 | } 129 | }, 130 | { 131 | "id":0, 132 | "rtp": { 133 | "codec": "PCMU", 134 | "rate":8000 135 | } 136 | }, 137 | { 138 | "id":8, 139 | "rtp": { 140 | "codec": "PCMA", 141 | "rate":8000 142 | } 143 | }, 144 | { 145 | "id":106, 146 | "rtp": { 147 | "codec": "CN", 148 | "rate":32000 149 | } 150 | }, 151 | { 152 | "id":105, 153 | "rtp": { 154 | "codec": "CN", 155 | "rate":16000 156 | } 157 | }, 158 | { 159 | "id":13, 160 | "rtp": { 161 | "codec": "CN", 162 | "rate":8000 163 | } 164 | }, 165 | { 166 | "id":126, 167 | "rtp": { 168 | "codec": "telephone-event", 169 | "rate": 8000 170 | } 171 | } 172 | ], 173 | "connection": { 174 | "networkType": "IN", 175 | "addressType": "IP4", 176 | "connectionAddress": "0.0.0.0" 177 | }, 178 | "rtcp": "9 IN IP4 0.0.0.0", 179 | "ice-ufrag": "Lw5NgNWQ", 180 | "ice-pwd": "qfy9wvi9J3g7G", 181 | "fingerprint": "sha-256 36:B6:83:67:03:BB:", 182 | "setup": "active", 183 | "mid": "audio", 184 | "extmap": [ 185 | "1 urn:ietf:params:rtp-hdrext:ssrc-audio-level", 186 | "3 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time" 187 | ], 188 | "sendrecv": true, 189 | "rtcp-mux":true, 190 | "maximumPacketTime": 60, 191 | "ssrc": [ 192 | "3140675822 cname:STNh4RdVs", 193 | "3140675822 msid:8pjbfuaudq", 194 | "3140675822 mslabel:8pjbfua", 195 | "3140675822 label:40fff5e6-d618-4b7a" 196 | ] 197 | } 198 | ] 199 | } 200 | 201 | Please note that 202 | - `payloads` have been aggregated 203 | - for some SDP parameters, the object property names are expanded 204 | - the properties with multiple values are aggregated into an array 205 | 206 | ## Development 207 | If you want to involve in this project as a developer please read the short [development guide](dev.md). 208 | -------------------------------------------------------------------------------- /src/main/pegjs/SdpParser.pegjs: -------------------------------------------------------------------------------- 1 | /** Developed according to https://tools.ietf.org/html/rfc4566 */ 2 | 3 | { 4 | var jsCommon = require("jscommon"); 5 | var guessType = jsCommon.guessType, isInt = jsCommon.isInt; 6 | 7 | /** The offset of the NTP time compared to Unix time. */ 8 | var NTP_OFFSET = 2208988800; 9 | 10 | var DURATIONS = { "d": 86400, "h": 3600, "m": 60, "s": 1}; 11 | DURATIONS.FORMAT_ORDER = ["d", "h", "m"]; 12 | 13 | /** End of line. */ 14 | var EOL = "\r\n"; 15 | 16 | /** The SDP types and the corresponding properties. */ 17 | var SDP_TYPES = { 18 | v: "version" 19 | , o: "origin" 20 | , s: "sessionName" 21 | , i: "sessionDescription" 22 | , u: "uri" 23 | , e: "emailAddress" 24 | , p: "phoneNumber" 25 | , c: "connection" 26 | , m: "media" 27 | , b: "bandwidth" 28 | , t: "timing" 29 | , r: "repeat" 30 | , z: "timezones" 31 | , k: "encryptionKey" 32 | , cat: "category" 33 | , keywds: "keywords" 34 | , ptime: "packetTime" 35 | , maxptime: "maximumPacketTime" 36 | , orient: "orientation" 37 | , rtp: "rtpmap" 38 | , "payloads": "" 39 | }; 40 | 41 | for (var t in SDP_TYPES) { 42 | if (SDP_TYPES.hasOwnProperty(t)) { 43 | SDP_TYPES[SDP_TYPES[t]] = t; 44 | } 45 | } 46 | 47 | var aggregateSdpProperties = function(sdpProperties) { 48 | var sdp = {}; 49 | var obj = sdp; 50 | for (var i = 0; i < sdpProperties.length; i++) { 51 | for (var p in sdpProperties[i]) { 52 | if (sdpProperties[i].hasOwnProperty(p)) { 53 | if (options.useMediaSections !== false && p == SDP_TYPES["m"]) { 54 | obj = sdp; 55 | } 56 | if (obj[p]) { 57 | if (!obj[p].push) { 58 | obj[p] = [obj[p]]; 59 | } 60 | obj[p].push(sdpProperties[i][p]); 61 | } else { 62 | obj[p] = sdpProperties[i][p]; 63 | } 64 | if (options.useMediaSections !== false && p == SDP_TYPES["m"]) { 65 | obj = sdpProperties[i][p]; 66 | } 67 | } 68 | } 69 | } 70 | return sdp; 71 | }; 72 | 73 | var aggregateSdp = function(sdpProperties) { 74 | var sdp = aggregateSdpProperties(sdpProperties); 75 | // ensure that media is an array 76 | if (sdp.media && !sdp.media.join) { 77 | sdp.media = [sdp.media]; 78 | } 79 | 80 | // aggregate payloads in each media section 81 | if (options.aggregatePayloads !== false) { 82 | aggregatePayloads(sdp); 83 | } 84 | return sdp; 85 | }; 86 | 87 | var aggregate = aggregateSdp; 88 | 89 | var aggregatePayloads = function(sdp) { 90 | if (!sdp.media || !sdp.media.length) { 91 | return sdp; 92 | } 93 | for (var i = 0; i < sdp.media.length; i++) { 94 | var m = sdp.media[i]; 95 | if (!m.payloads) { 96 | continue; 97 | } 98 | var payloads = []; 99 | for (var j = 0; j < m.payloads.length; j++) { 100 | var payload = {id: m.payloads[j]}; 101 | aggregatePayloadAttribute(payload, m, "rtp"); 102 | aggregatePayloadAttribute(payload, m, "fmtp"); 103 | payloads[j] = payload; 104 | } 105 | if (m.rtp) { 106 | delete m.rtp; 107 | } 108 | if (m.fmtp) { 109 | delete m.fmtp; 110 | } 111 | m.payloads = payloads; 112 | } 113 | return sdp; 114 | }; 115 | 116 | var aggregatePayloadAttribute = function(payload, media, attr) { 117 | if (media[attr] && !media[attr].push) { 118 | media[attr] = [media[attr]]; 119 | } 120 | if (media[attr]) { 121 | payload[attr] = getPayload(media[attr], payload.id); 122 | } 123 | if (payload[attr]) { 124 | delete payload[attr].payload; 125 | } else { 126 | delete payload[attr]; 127 | } 128 | }; 129 | 130 | var getPayload = function(payloads, id) { 131 | if (payloads.payload === id) { 132 | return payloads; 133 | } 134 | for (var i = 0; i < payloads.length; i++) { 135 | if (payloads[i].payload === id) { 136 | return payloads[i]; 137 | } 138 | } 139 | return null; 140 | }; 141 | 142 | var OUTPUT_ORDER = ["v", "o", "s", "i", "u", "e", "p", "c", "b", "t", "r", "z", "k", "a", "*", "m"]; 143 | var MEDIA_OUTPUT_ORDER = ["i", "c", "b", "k", "rtcp", "ice-ufrag", "ice-pwd", "fingerprint", "setup", "mid", "extmap", "sendrecv", "rtcp-mux", "payloads", "ptime", "maxptime", "ssrc"]; 144 | var getOutputOrder = function(order, property) { 145 | var idx = order.indexOf(property); 146 | if (idx < 0) { 147 | idx = order.indexOf(SDP_TYPES[property]); 148 | } 149 | if (idx < 0) { 150 | idx = order.indexOf("*"); 151 | } 152 | if (idx < 0) { 153 | idx = order.length; 154 | } 155 | }; 156 | 157 | var ordering = function(order) { 158 | return function(a, b) { 159 | return getOutputOrder(order, a) - getOutputOrder(order, b); 160 | }; 161 | }; 162 | 163 | var formatSdp = function(sdp) { 164 | return formatSdpSection(sdp, null, OUTPUT_ORDER); 165 | }; 166 | 167 | parser.format = formatSdp; 168 | 169 | var formatSdpSection = function(section, excluded, order) { 170 | var s = ""; 171 | 172 | jsCommon.forEach(section, 173 | function(value, property, section) { 174 | s += formatSdpProperty(section, property); 175 | }, 176 | { 177 | blacklist: excluded ? function(p) { return excluded.indexOf(p) >= 0 || excluded.indexOf(SDP_TYPES[p]) >= 0;} : null, 178 | comparator: ordering(order) 179 | }); 180 | 181 | // remove empty lines - it seems that browsers cannot deal with empty lines in SDP, even at the end 182 | s = s.replace(/[\r\n]{2,}/g, EOL); 183 | return s; 184 | }; 185 | 186 | var formatSdpProperty = function(section, propertyName) { 187 | // if the property does not exist, return empty 188 | if (section[propertyName] === undefined) { 189 | return ""; 190 | } 191 | // get the prefix of the property according to SDP specs 192 | var prefix = SDP_TYPES[propertyName] !== undefined ? SDP_TYPES[propertyName] : propertyName; 193 | // gets the formatter for the property 194 | var formatter = FORMATTERS[propertyName] || FORMATTERS[prefix] || FORMATTERS["*"]; 195 | // if the prefix is one single character, then it is a SDP type 196 | // otherwise it is a SDP attribute 197 | if (prefix.length > 1) { 198 | prefix = "a=" + prefix; 199 | if (section[propertyName] === false) { 200 | return ""; 201 | } 202 | if (section[propertyName] === true) { 203 | return prefix + EOL; 204 | } 205 | prefix += ":"; 206 | } else if (prefix.length > 0) { 207 | prefix += "="; 208 | } 209 | 210 | if (propertyName !== "timezones" && section[propertyName].push) { 211 | var s = ""; 212 | for (var i = 0; i < section[propertyName].length; i++) { 213 | s += prefix + formatter(section[propertyName][i], section[propertyName]) + (prefix.length ? EOL : ""); 214 | } 215 | return s; 216 | } 217 | return prefix + formatter(section[propertyName], section) + (prefix.length ? EOL : ""); 218 | }; 219 | 220 | // A formatter for each SDP property or attribute. The default one is "*" 221 | // A formatter is a function that receives the property value and the section 222 | var FORMATTERS = { 223 | "*": function(value) { 224 | return value.toString(); 225 | } 226 | , origin: function(origin) { 227 | return origin.username + " " + origin.sessionId 228 | + " " + origin.sessionVersion 229 | + " " + origin.networkType 230 | + " " + origin.addressType 231 | + " " + origin.unicastAddress; 232 | } 233 | , timing: function(timing) { 234 | return timing.start + " " + timing.stop; 235 | } 236 | , duration: function(duration) { 237 | if (duration === 0) { 238 | return duration; 239 | } 240 | for (var i = 0, n = DURATIONS.FORMAT_ORDER.length; i < n; i++) { 241 | var x = duration / DURATIONS[DURATIONS.FORMAT_ORDER[i]]; 242 | if (isInt(x)) { 243 | return x + DURATIONS.FORMAT_ORDER[i]; 244 | } 245 | } 246 | return duration; 247 | } 248 | , repeat: function(repeat) { 249 | var s = FORMATTERS.duration(repeat.interval) + " " + FORMATTERS.duration(repeat.activeDuration); 250 | for (var i = 0, n = repeat.offsets.length; i < n; i++) { 251 | s += " " + FORMATTERS.duration(repeat.offsets[i]); 252 | } 253 | return s; 254 | } 255 | , timezones: function(timezones) { 256 | var s = ""; 257 | for (var i = 0, n = timezones.length; i < n; i++) { 258 | s += (i > 0 ? " " : "") + timezones[i].adjustment + " " + FORMATTERS.duration(timezones[i].offset); 259 | } 260 | return s; 261 | } 262 | , encryptionKey: function(encryptionKey) { 263 | return encryptionKey.method + (encryptionKey.key ? ":" + encryptionKey.key : ""); 264 | } 265 | , media: function(media) { 266 | var s = media.type 267 | + " " + media.port 268 | + (media.numberOfPorts ? "/" + media.numberOfPorts : "") 269 | + " " + media.protocol; 270 | if (media.formats) { 271 | s += " " + media.formats.join(" ") + EOL; 272 | } 273 | if (media.payloads) { 274 | for (var i = 0; i < media.payloads.length; i++) { 275 | s += " " + media.payloads[i].id; 276 | } 277 | s += EOL; 278 | } 279 | s += formatSdpSection(media, ["type", "port", "protocol", "numberOfPorts", "formats"], MEDIA_OUTPUT_ORDER); 280 | return s; 281 | } 282 | , payloads: function(payload) { 283 | return formatSdpSection(payload, ["id"], ["rtp", "fmtp"]); 284 | } 285 | , rtpmap: function(rtp, parent) { 286 | var s = parent.id + " " + rtp.codec + "/" + rtp.rate; 287 | if (rtp.codecParams) { 288 | s += "/" + rtp.codecParams; 289 | } 290 | return s; 291 | } 292 | , fmtp: function(fmtp, parent) { 293 | var s = parent.id + " "; 294 | if (fmtp.params.split) { 295 | s += fmtp.params; 296 | } else { 297 | var i = 0; 298 | for (var p in fmtp.params) { 299 | if (fmtp.params.hasOwnProperty(p)) { 300 | s += (++i === 1 ? "" : "; ") + p + "=" + fmtp.params[p]; 301 | } 302 | } 303 | } 304 | return s; 305 | } 306 | , connection: function(connection) { 307 | return connection.networkType 308 | + " " + connection.addressType 309 | + " " + connection.connectionAddress; 310 | } 311 | }; 312 | 313 | } 314 | 315 | 316 | sdp 317 | = line:(line:SdpLine {return line;}) lines:(_eol line2:SdpLine {return line2;})* _eol* 318 | { 319 | lines.splice(0, 0, line); 320 | var sdp = aggregate(lines); 321 | return sdp; 322 | }; 323 | 324 | _eol = [\r\n]+ 325 | 326 | _ =[ \t]+; 327 | 328 | eq = "="; 329 | 330 | versionNumber 331 | = n: number { return n; }; 332 | 333 | number 334 | = n: ([\-0-9]+) { return guessType(text()); }; 335 | 336 | str 337 | = s: ([^ \t\n\r]+) { return text();} 338 | 339 | SdpLine 340 | = version / origin / media / connection / timing / repeat / timezones / encryptionKey / bandwidth / attribute / otherType; 341 | 342 | version 343 | = "v" eq v: versionNumber { return {version: v}; }; 344 | 345 | time 346 | = t: number { return options.useUnixTimes ? t - NTP_OFFSET : t;}; 347 | 348 | duration 349 | = x:number p:("d" / "h" / "m" / "s") { return x * DURATIONS[p];} 350 | / x:number { return x;}; 351 | 352 | 353 | origin 354 | = "o" eq 355 | username:str 356 | _ sessionId:str 357 | _ sessionVersion:versionNumber 358 | _ networkType:str 359 | _ addressType:str 360 | _ unicastAddress:str 361 | { 362 | var o = { 363 | username: username, 364 | sessionId: sessionId, 365 | sessionVersion: sessionVersion, 366 | networkType: networkType, 367 | addressType: addressType, 368 | unicastAddress: unicastAddress 369 | }; 370 | var or = {}; 371 | or[SDP_TYPES["o"]] = o; 372 | return or; 373 | }; 374 | 375 | connection 376 | = "c" eq 377 | networkType:str 378 | _ addressType:str 379 | _ connectionAddress: str 380 | { 381 | return {connection: { 382 | networkType: networkType, 383 | addressType: addressType, 384 | connectionAddress: connectionAddress 385 | }}; 386 | }; 387 | 388 | media 389 | = "m" eq type:str 390 | _ port:number 391 | numberOfPorts:("/" n:number {return n;}) ? 392 | _ protocol:([^ \t]+ {return text();}) 393 | formats:(_ format:str { return format;})+ 394 | { 395 | var m = { 396 | type: type 397 | , port: port 398 | , protocol: protocol 399 | }; 400 | if (numberOfPorts) { 401 | m.numberOfPorts = numberOfPorts; 402 | } 403 | // TODO better detection of RTP 404 | if (options.parseRtpPayloads !== false && protocol.indexOf("RTP/") >= 0) { 405 | m.payloads = formats; 406 | m.payloads.forEach(function(value, index, arr) { 407 | arr[index] = guessType(value); 408 | }); 409 | } else { 410 | m.formats = formats; 411 | } 412 | return {media: m}; 413 | } 414 | 415 | bandwidth 416 | = "b" eq type: str ":" value: str { return {bandwidth: {type: type, value: value}}}; 417 | 418 | timing 419 | = "t" eq start:time _ stop:time {return {timing:{start: start, stop: stop}}}; 420 | 421 | repeat 422 | = "r" eq interval:duration _ activeDuration:duration offsets:(_ d:duration {return d;})* 423 | { return {repeat: {interval: interval, activeDuration: activeDuration, offsets: offsets}}}; 424 | 425 | timezones 426 | = "z" eq t:timezone ts:(_ t2:timezone {return t2;})+ 427 | { return {timezones: [t].concat(ts)};}; 428 | 429 | timezone 430 | = adjustment:number _ offset:duration {return {adjustment: adjustment, offset: offset}}; 431 | 432 | encryptionKey 433 | = "k" eq method:([^:\r\n]+ {return text();}) ":" key:str { return {encryptionKey: {method: method, key: key}};} 434 | / "k" eq method:str { return {encryptionKey: {method: method}};}; 435 | 436 | attribute 437 | = rtpmapAttribute / fmtpAttribute / valueAttribute / propertyAttribute; 438 | 439 | rtpmapAttribute 440 | = "a" eq "rtpmap" ":" payload:number 441 | _ codec:([^/]+ {return text();}) 442 | "/" rate:number codecParams:("/" params:str {return guessType(params);})? 443 | { 444 | var rtp = { 445 | payload: payload, 446 | codec: codec, 447 | rate: rate 448 | }; 449 | if (codecParams) { 450 | rtp.codecParams = codecParams; 451 | } 452 | return {rtp: rtp}; 453 | }; 454 | 455 | fmtpAttribute 456 | = "a" eq "fmtp" ":" payload:number 457 | _ params:formatParameters 458 | { 459 | return { fmtp: { 460 | payload: payload, 461 | params: params 462 | }}; 463 | }; 464 | 465 | formatParameters 466 | = param:formatParameter params:(";" [ \t]* p:formatParameter {return p;})* 467 | { 468 | if (params) { 469 | params.splice(0, 0, param); 470 | } else { 471 | params = [param]; 472 | } 473 | return aggregateSdpProperties(params); 474 | } 475 | / config:[^\r\n]+ { return text();}; 476 | 477 | formatParameter 478 | = name:([^=;\r\n]+ {return text()}) 479 | eq value:([^;\r\n]+ {return guessType(text());}) 480 | { var param = {}; param[name] = value; return param;} 481 | 482 | propertyAttribute 483 | = "a" eq property: attributeName 484 | { 485 | var p = {}; 486 | p[property] = true; 487 | return p; 488 | } 489 | 490 | valueAttribute 491 | = "a" eq property: attributeName ":" value:([^\n\r]+ {return guessType(text());}) 492 | { 493 | var p = {}; 494 | p[property] = value; 495 | return p; 496 | } 497 | 498 | attributeName 499 | = ([^\n\r:]+) 500 | { 501 | var name = text(); 502 | if (options["useLongNames"] !== false && SDP_TYPES[name]) { 503 | return SDP_TYPES[name]; 504 | } 505 | return name; 506 | }; 507 | 508 | otherType 509 | = type: [a-z] eq value: ([^\r\n]+ {return text();}) 510 | { 511 | var t = {}; 512 | t[SDP_TYPES[type] ? SDP_TYPES[type] : type] = value; 513 | return t; 514 | }; 515 | --------------------------------------------------------------------------------