Home

Awesome

rtc-attach

Roughly equivalent to the attachMediaStream package but with support for rtc.io plugins. Also uses an error first async API to allow plugins time to initialize.

NPM

unstable rtc.io google group

Example Usage

var capture = require('rtc-capture');
var attach = require('rtc-attach');

capture({ video: true, audio: true }, function(err, stream) {
  if (err) {
    return console.error('could not capture stream: ', stream);
  }

  attach.local(stream, function(err, el) {
    if (err) {
      return console.error('could not attach stream to element: ', err);
    }

    document.body.appendChild(el);
  });
});

Example using Plugins

var capture = require('rtc-capture');
var attach = require('rtc-attach');
var opts = {
  plugins: [
    require('rtc-plugin-nicta-ios'),
    require('rtc-plugin-temasys')
  ]
};

capture({ audio: true, video: true }, opts, function(err, stream) {
  if (err) {
    return console.error('could not capture stream: ', err);
  }

  attach.local(stream, opts, function(err, el) {
    if (err) {
      return console.error('could not attach stream: ', err);
    }

    document.body.appendChild(el);
  });
});

Reference

attach(stream, opts?, callback)

Attach stream to a HTML element that will render the content. The provided callback follows the format of fn(err, element). While the async nature of this package may seem odd, because a plugin may need time to initialize this caters for this case in addition to standard usage in the browser.

attach.local(stream, opts?, callback)

Attach a local stream with options appropriate for local streams:

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.