rtc-io/rtc-attach

Attach a media stream to an existing or new media element (basically attachMediaStream with support for rtc.io plugins)

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.

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.

• autoplay (default: true) - by default after the stream has been attached to the element it will be played. This is done by calling the play() function on the element rather than relying on autoplay attribute functionality.

• el (default: null) - if you with to supply an element to be used instead of creating a new element to receive the stream specify it here.

• muted (default: false) - whether the created element should be muted or not. For local streams this should almost always, be true so consider using the attach.local helper function for simple cases.

• plugins (default: []) - specify one or more plugins that can be used to render the media stream appropriate to the current platform in the event that WebRTC and/or media capture is supported via a browser plugin.

attach.local(stream, opts?, callback)

Attach a local stream with options appropriate for local streams:

• muted: true

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.

rtc-attach's Issues

attach.local should ensure that the video element is mirrored