@tobiipro/skylinkjs

SkylinkJS Javascript WebRTC SDK

Showing:

Popularity

Downloads/wk

1

GitHub Stars

1

Maintenance

Last Commit

4yrs ago

Contributors

22

Package

Dependencies

2

License

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Temasys Web SDK (formerly SkylinkJS) is an open-source client-side library for your web-browser that enables any website to easily leverage the capabilities of WebRTC and its direct data streaming powers between peers for audio/video conferencing or file transfer.

We've gone to great length to make this library work in as many browsers as possible. Temasys Web SDK is built on top of AdapterJS and works with our Temasys WebRTC Plugin even in Internet Explorer and Safari on Mac and PC.

You'll need a Temasys Account and an App key to use this. Register here to get your App key.

Supported Browsers

Browsers in Beta (Edge/Bowser/Safari):

Note that for beta supported browsers, some of the audio / video functionalities may not work well. Some older versions of Edge may require you to enable experimental support for H.264 video codec to interop with Chrome and Firefox browsers.

FeaturesChromeFirefoxOperaIE (plugin)Safari (beta)Safari (plugin)Edge (beta)Bowser (beta)
Platforms:Win, Mac, Ubuntu, AndroidWin, Mac, Ubuntu, AndroidWin, Mac, Ubuntu, AndroidWinMacMacWiniOS
Minimum Recommended Versions:524838911714.143520.6.1
ScreensharingYes with Chrome Extension**Yes with Firefox Extension**-Yes with Commercial Temasys Plugin*-Yes with Commercial Temasys Plugin*NoNo
Video CallYesYesYesYes with Temasys PluginYesYes Temasys PluginYes (with H264 flag enabled)Yes
Audio CallYesYesYesYes with Temasys PluginYesYes with Temasys PluginYesYes
File TransfersYesYesYesYes with Temasys PluginYesYes with Temasys PluginNoNo
Chat MessagingYesYesYesYes with Temasys Plugin for P2PYesYes with Temasys Plugin for P2PYes (Signaling only)Yes (Signaling only)
  • (+) Latest browser versions indicates the last tested browser version. It should work with the updated next versions, but if it doesn't, open a bug ticket.
  • (*) Custom Branded Temasys WebRTC Plugin incorporates additional features not available in the free plugin.
  • (**) Our extensions works with Temasys demos and localhost demos. You will have to modify the extension to work on your hosted Web Applications. For Chrome extensions source code, contact us. For Firefox extensions source code, you may download from your Application Key in console.temasys.io.
Installation

Install Temasys Web SDK (formerly SkylinkJS) with npm:

npm install skylinkjs@0.6.x

Install Temasys Web SDK (formerly SkylinkJS) with bower:

bower install skylinkjs

Read more

Need help or want something changed?

You can raise tickets on our support portal or on our Github Page.

Current versions and stability

We recommend that you always use the latest versions of the Temasys Web SDK as WebRTC is still evolving and we adapt to changes very frequently.

Latest version: 0.6.26.

Setting AdapterJS flags

If you require to set Temasys AdapterJS flags (e.g. forcing Temasys WebRTC plugin), we recommend the following method:

<script>
  // Example options.
  var AdapterJS = {
    options: {
      forceSafariPlugin: [Boolean],
      hidePluginInstallPrompt: [Boolean],
      getAllCams: [Boolean]
    }
  };
</script>
<! -- Now reference AdapterJS or SkylinkJS (complete version) -->
<script src="https://cdn.temasys.io/skylink/skylinkjs/0.6.x/skylink.complete.js"></script>

For more details, please read the documentation in Temasys AdapterJS.

Noted Issues and Solutions

Installing 0.6.3 - 0.6.10 versions in NPM

Due to corrupt files issues for versions 0.6.3 - 0.6.10, we have removed these versions from the NPM repository. You may still install these versions using this command:

npm install git://github.com/Temasys/SkylinkJS#<version_tag>
Encoding issues from AdapterJS dependency

There is a known issue caused by AdapterJS 0.14.0 which manifests as incorrectly encoded characters. To resolve this, it is recommended that charset is set the HTML file:

<meta charset="utf-8">
Upgrading from 0.5.7 and below:

It's now recommended to use the init() callback instead of using readyStateChange complete state as this may result in an infinite loop.

readyStateChange triggers each time the current room information is recieved, and joining a room other than default room will result in a re-fetch from the API server. This can result in a endless re-join loop.

// Use this
sw.init(data, function () {
  sw.joinRoom('name');
});

// Instead of
sw.on('readyStateChange', function (state) {
  if (state === sw.READY_STATE_CHANGE.COMPLETED) {
     sw.joinRoom('name');
  }
});

How to build your own Temasys Web SDK

Using Git command line tools, execute the following:

# 1. Clone or download this repository via git terminal.

git clone https://github.com/Temasys/SkylinkJS.git

# 2. Install all required dependencies. Use (sudo npm install) if required.

npm install

# 3. Install Grunt to run tasks.

npm install grunt -g
npm install grunt-cli -g

# 4. Install Browserify and Testling to run test scripts :

> **Note** that currently the test scripts are outdated and may not work as we are evaluating to upgrade the test scripts in the future.

npm install browserify -g
npm install testling -g

# 5. Run the start script to start a local webserver to be able access the demo and doc folders. This will popup Chrome (Mac). You can configure a different browsers in the start.sh file. Alternatively, you can run (sh start.sh)

npm start # note that this runs in Chrome currently..

After making edits, here are some commands to run and build the Temasys Web SDK:

  • grunt jshint : Validate for formatting and syntax errors.
  • grunt yuidoc : To generate the SDK documentation.
  • grunt dev : Compile the SDK.
  • grunt publish : Publish a release.

What's included in the repository?

  • demo : Reference Code Examples.
  • doc : Generated documentation for the Temasys Web SDK.
  • doc-style : Templates used documentation.
  • publish : Production version of the library as well as minified variants
  • source : Temasys Web SDK source
  • tests : Test suite.

License

APACHE 2.0

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial