rtc-dcstream

Streams interface for the WebRTC data channel

npm install rtc-dcstream
22 downloads in the last week
31 downloads in the last month

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

Build Status unstable

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 dropkick = require('dropkick');
var quickconnect = require('rtc-quickconnect');
var fileReader = require('filestream/read');
var fileReceiver = require('filestream/write');
var createDataStream = require('rtc-dcstream');
var channels = [];
var peers = [];
var inbound = {};

function prepStream(dc, id) {
  createDataStream(dc).pipe(fileReceiver(function(file, metadata) {
    console.log('received file from: ' + id, file, metadata);

    // get ready to receive another stream
    setTimeout(function() {
      prepStream(dc, id);
    }, 50);
  }));
}

quickconnect('http://rtc.io/switchboard', { room: 'filetx-test' })
  .createDataChannel('files')
  .on('files:open', function(dc, id) {
    channels.push(dc);
    peers.push(id);

    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.map(createDataStream).forEach(function(stream) {
    fileLoader(file).pipe(stream);
  });
});

// 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 2014 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.

npm loves you