Wraps a core browser RTCDataChannel with a buffering layer to ensure data channel send limits are observed
This is a wrapper for a native
RTCDataChannel that ensures that data
sent over the channel complies with the current data channel size limits
(which is < 16Kb for firefox <--> chrome interop).
rtc-bufferedchannel module is able to wrap any standard
RTCDataChannel object. If you use other WebRTC helper libraries, then
this module can still be very useful!
rtc-bufferedchannel works by wrapping a standard
an object that proxies
send function calls and emits data through an
channel.on('data', handler) event handler for receiving data. When you
send function provided by buffered channel it determines the size
of the message that you are sending and determines whether that needs to be
"chunked" to assist with successful delivery of your data.
At this present point in time, a browser will complain if you attempt to
send large payloads of data via a data channel, and this is where the
rtc-bufferedchannel module comes to your rescue.
email@example.com all manner of typed integer arrays (int,
uint, etc) are catered for and correctly chunked to ensure successful delivery.
Additionally, the module will provide identification of the typed array type
before sending the raw data across the wire. Using this functionality when
you receive the
data event from the buffered channel you will receive the
data in the same format it was sent from your peer, i.e.
Uint8Array out which is different to the standard
data channel functionality.
Shown below is a simple example of how you might use a buffered channel to send data that is larger than what you can typically send over a webrtc data channel:
var quickconnect = require'rtc-quickconnect';var buffered = require'rtc-bufferedchannel';// include the base64 encoded image datavar mentosImage = require'../test/data/dietcoke-mentos';quickconnect'' room: 'buffertest'createDataChannel'mentos'once'mentos:open'var bc = buffereddc;console.log'found new peer (id = ' + id + '), sending an image';// when we get some data, then create a new imagebcon'data'var img;console.log'received some image data' data;img = documentcreateElement'img';imgsrc = data;documentbodyappendChildimg;;// send the mentos data to the person that just connected to usbcsendmentosImage;;
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
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.