sdp-jingle-json

2019-09-11

sdp-jingle-json是什么

什么是sdp-jingle-json,A parser/serializer for SDP to JSON. Useful for converting SDP to other formats like Jingle for WebRTC signalling

sdp-jingle-json使用教程帮助文档

SDP-Jingle-JSON

Convert SDP blobs to and from JSON

Build StatusDependency StatusdevDependency Status

Browser Support

What is this?

Ever taken a peek at the data blobs that get sent back and forth in WebRTC signalling? Yeah, that mess of line-oriented data is SDP. But sometimes you want to have that data available in JSON, like if you want to use XMPP Jingle for signalling.

This library will convert raw SDP into JSON that mirrors the structure of XMPP Jingle content, making it simple to convert the SDP data into an XMPP stanza with any of the various JS XMPP libraries, such as stanza.io, or xmpp-ftw.

And since you're working with WebRTC, be sure to check out simplewebrtc.

Installing

npm install sdp-jingle-json

Building bundled/minified version (for AMD, etc)

$ grunt

The bundled and minified files will be in the generated builddirectory.

How to use it

var sjj = require('sdp-jingle-json');

// I have SDP, but want JSON:
var json = sjj.toSessionJSON(sdpBlob, {
    creators: ['initiator', 'initiator'], // Who created the media contents
    role: 'initiator',   // Which side of the offer/answer are we acting as
    direction: 'outgoing' // Are we parsing SDP that we are sending or receiving?
});

// I have JSON (a dictionary of session and content descriptions), but want SDP:
var sdp = sjj.toSessionSDP(jsonSession, {
    role: 'responder',
    direction: 'incoming'
});

You can also use toMediaSDPand toMediaJSONto convert only a single media section.

See it in action

Open the convert.htmlfile and enter in SDP or JSON to see how it converts back and forth.

Jingle JSON

The format for the generated JSON content is:

{
    "action": "",
    "initiator": "",
    "responder": "",
    "sid": "",
    // ---- Content payload
    "groups": [
        {
            "semantics": "",
            "contents": [],
        } //...
    ],
    "contents": [
        {
           "name": "",
           "creator": "",
           "senders": "",
           "application": {
               // ---- RTP description
               "applicationType": "rtp",
               "media": "",
               "ssrc": "",
               "sourceGroups": [
                    {
                        "semantics": "",
                        "sources": [
                            "" //...
                        ]
                    } //...
               ],
               "sources": [
                   {
                       "ssrc": "",
                       "parameters: [
                           {
                               "key": "",
                               "value": ""
                           } //...
                       ]
                   } //...
               ],
               "bandwidth": "",
               "bandwidthType": "",
               "headerExtensions": [
                   {
                       "id": "",
                       "uri": "",
                       "senders": ""
                   } //...
               ],
               "payloads": [
                   {
                       "id": "",
                       "channels": "",
                       "clockrate": "",
                       "maxptime": "",
                       "ptime": "",
                       "name": "",
                       "parameters": [
                           {
                               "key": "",
                               "value": ""
                           } //...
                       ],
                       "feedback": [
                           {
                               "type": "",
                               "subtype": "",
                               "value": ""
                           } //...
                       ]
                   }
                ],
                "encryption": [
                    {
                        "cipherSuite": "",
                        "keyParams": "",
                        "sessionParams": "",
                        "tag": ""
                    } //...
                ]
           },
           "transport": {
               // ---- ICE UDP transport
               "transportType": "iceUdp",
               "ufrag": "",
               "pwd": "",
               "setup": "",
               "candidates": [
                   {
                       "component": "",
                       "foundation": "",
                       "generation": "",
                       "id": "",
                       "ip": "",
                       "network": "",
                       "port": "",
                       "priority": "",
                       "protocol": "",
                       "relAddr": "",
                       "relPort": "",
                       "type": ""
                   } //...
               ],
               "fingerprints": [
                   {
                   "hash": "",
                   "value": ""
                   } // ...
               ]
           }
        } //...
    ]
}

License

MIT

Created By

If you like this, follow @lancestoutor @HCornfloweron twitter.

SDP-Jingle-JSON is derived, in collaboration, from the work done by Philipp Hancke for strophe.jingle.


上一篇:filetransfer
下一篇:rtcpeerconnection
相关教程
关注微信

扫码加入 JavaScript 社区

相关文章

首次访问,需要验证
微信扫码,关注即可
(仅需验证一次)

欢迎加入 JavaScript 社区

号内回复关键字:

回到顶部