Web SDK 1.0

The Web SDK APIs are split into two main categories: Express and Low-Level. We recommend that you start with the Express API as this:

1. Simplifies integration
2. Automatically recovers from stream failures
3. Handles edge cases such as network reconnects

Our Express APIs provide a simple, single-step API for the easiest integration of streaming into your application. Common use cases include:

• Channel (one to many) -> Channel
• Group Broadcast (few to many) -> Room
• Group Chat (many to many) -> Room
• One to One Chat -> Room

If you find that the Express API doesn't work for you, take a look at our Lower Level API.

Please refer to npmjs.org for the latest available version.

The Web SDK is available at npmjs.org and can be installed as a pre-built universal module using several dependency management tools. The Web SDK may be included directly in the browser or bundled using your favorite bundling tool such as Webpack or Rollup. For a full list of browser support see Browser Support.

Yarn

yarn add phenix-web-sdk

NPM

npm install -S phenix-web-sdk

Bower

bower install -S phenix-web-sdk

The universal module is available uncompressed and minified.

phenix-web-sdk.js

phenix-web-sdk.min.js

Use your favorite bundling tool such as Webpack or Rollup.

import * as sdk from 'phenix-web-sdk';
// Or Import just what you need
import { express, utils, net } from 'phenix-web-sdk';

const sdk = require('phenix-web-sdk');

define(['phenix-web-sdk'], function (sdk) {
  // use sdk
});

Load it directly in the browser in a script tag.

var sdk = window['phenix-web-sdk'];

If you are using ember.js for your frontend, then you can add the Web SDK by generating a vendor shim:

ember generate vendor-shim phenix-web-sdk

Then modify ember-cli-build.js as shown:

app.import({
  development: 'bower_components/phenix-web-sdk/dist/phenix-web-sdk.js',
  production: 'bower_components/phenix-web-sdk/dist/phenix-web-sdk.min.js',
});
app.import('vendor/shims/phenix-web-sdk.js');

import sdk from 'phenix-web-sdk';
// use sdk

We recommend that you include the minified version of the web-sdk in your production app or bundle(s). We optimize this bundle for size using smart transformations.

You can alias phenix-web-sdk in your webpack production config to use the minified version.

{
    resolve: {
        alias: {
            'phenix-web-sdk': path.resolve(__dirname, '../node_modules', 'phenix-web-sdk/dist/phenix-web-sdk.min.js'),
        }
    }
}

Observe value changes. Similar to the RxJS Behavior Subject

Receive a notification every time the observable value changes.

var subscription = observable.subscribe(function (newValue) {
  // Do something with newValue
}, options);
 
setTimeout(function () {
  // Stop listening to notifications after 1 second
  subscription.dispose();
}, 1000);

Value may be of any supported javascript type

observable.getValue(value);

Change the observable value. This will trigger notifications on all subscribers.

observable.setValue(value);