Installation - Storm JavaScript Library

Storm JavaScript Library can be easily installed using popular package managers like npm and yarn. You can also attach js file from our CDN. Below you'll find more detailed instructions.

Storm CDN

Feel free to pick our Storm Library (in IIFE format) from our CDN:

                        
<script src="https://cdn.stormstreaming.com/stormlibrary/4-latest.min.js"></script>
                            

Optionally you can link to the latest major.minor, for example 4.0-latest.min.js, or pick specific release: 4.0.0.min.js

Installation via package managers

1. NPM - To include Storm Library in Node, first install Node.js

   To include Storm Library in Node, first install NPM

                                   
   npm install @stormstreaming/stormlibrary
                               

2. Yarn - Before using Yarn, make sure to install it first

   Before using Yarn, make sure to install it first

                                   
   yarn add @stormstreaming/stormlibrary
                               

Manual installation

You can manually grab index.js from /dist/iife folder on our Git-Hub page. You will find the latest release here: https://github.com/StormStreaming/stormlibrary-js/releases

Embedding the library

Storm Library comes in IIFE, ESM, AMD, UMD and CJS formats. If you are unfamiliar with these, please grab IIFE version, as it's easiest to embed in a modern browser. All packages are located in /dist folder under their respective names.

Initiating the library

Once the library is properly linked to your page, an instance can be finally created. Please keep in mind that you can create and manage multiple instances of Storm Library at a time. Each instance requires a valid configuration object in order to work properly. Initialization will look different depending on picked JavaScript format.

                        
const streamConfig = {
    configurationType: "embedded",
    stream: {
        serverList: [{
            host: "localhost",
            application: "live",
            port: 80,
            ssl: false
        }],
        sourceList: [{
            protocol: "storm",
            streamKey: "test"
        }],
    },
    settings: {
        autoStart: true,
        video: {
            containerID: "containerID",
            width: "100%",
            aspectRatio: "16:9"
        },
    },
};
                    

Initialization will look different depending on picked JavaScript format.

1. IIFE (Immediately invoked function expression)

                                   
   const storm = stormLibrary(streamConfig);
                               

2. ESM (ECMAScript Modules)

                                   
   import {StormLibrary} from "../../dist/esm/index.js";
   const storm = new StormLibrary(streamConfig);
                               

3. UMD (Universal Module Definition)

                                   
   const storm = stormLibrary.create(streamConfig);
                               

4. AMD (Asynchronous Module Definition)

                                   
   requirejs(['../../dist/amd/index'], function (storm) {
       const stormInstance = new storm.create(streamConfig);
   });