Node streams2 layer for working with WebRTC data channels
JavaScript
Permalink
Failed to load latest commit information.
examples Specify type in the filetransfer example Mar 23, 2015
test
.gitignore Ignore the local .travis symlink Dec 9, 2014
.travis.yml
.zuul.yml
AUTHORS Initial commit Dec 2, 2013
LICENSE Initial commit Dec 2, 2013
README.md
docs.json
index.js
package.json

README.md

rtc-dcstream

Node streams2 interface for working with WebRTC data channels. This stream implementation will cater for current data size limits in the WebRTC data channels.

NPM

unstable Build Status bitHound Score

Example Usage

The example below shows how to use the rtc-dcstream module to stream data via a datachannel to n remote participants. In this case we are using the W3C FileReader API and streaming dropped data files over the data channel:

var crel = require('crel');
var dropkick = require('dropkick');
var quickconnect = require('rtc-quickconnect');
var fileReader = require('filestream/read');
var fileReceiver = require('filestream/write');
var multiplex = require('multiplex');
var createDataStream = require('rtc-dcstream');
var channels = [];
var peers = [];
var inbound = {};

function prepStream(dc, id) {
  var plex = multiplex();

  plex.pipe(createDataStream(dc)).pipe(multiplex(function(stream, type) {
    stream.pipe(fileReceiver(function(file) {
      document.body.appendChild(crel('img', { src: URL.createObjectURL(file) }));
    }, { type: type }));
  }));

  return plex;
}

quickconnect('http://rtc.io/switchboard', { room: 'filetx-test' })
  .createDataChannel('files')
  .on('channel:opened:files', function(id, dc) {
    peers.push(id);
    channels.push(prepStream(dc, id));
  })
  .on('peer:leave', function(id) {
    var peerIdx = peers.indexOf(id);
    if (peerIdx >= 0) {
      peers.splice(peerIdx, 1);
      channels.splice(peerIdx, 1);
    }
  })

dropkick(document.body).on('file', function(file) {
  channels.forEach(function(plex) {
    fileReader(file).pipe(plex.createStream(file.type));
  });
});

// give the document some size so we can drag and drop stuff
document.body.style.width = '100vw';
document.body.style.height = '100vw';

Alternative Implementations

In addition to this module, the following are other modules that wrap WebRTC data channel communication via a node streaming interface:

Reference

To be completed.

License(s)

Apache 2.0

Copyright 2015 National ICT Australia Limited (NICTA)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.