This project is an SDK built on top of the @millicast/sdk library to provide an easier way to manage bi-directional communications on the Dolby.io Real-time Streaming (Millicast) platform.
To get started, install this SDK into your web application. The @millicast/sdk library will be installed as a dependency.
npm install @millicast/sdk-interactivityThe SDK can trigger the following events:
-
publisherJoined- Event triggered when a new publisher starts publishing to the stream. -
publisherLeft- Event triggered when a publisher stops publishing to the stream. -
sourceAdded- Event triggered when a new source is being published to the stream. -
sourceRemoved- Event triggered when a source stopped being published. -
viewercount- Event triggered from time to time to indicate the number of viewers connected to the stream.
import { Publisher, Room, Source } from '@millicast/sdk-interactivity';
const room = new Room({
streamName,
streamAccountId,
});
room.on('viewercount', (count: number) => console.log('Viewer count is', count));
room.on('sourceAdded', async (publisher: Publisher, source: Source) => {
const { sourceId } = source;
console.log(`New ${sourceId.sourceType} source: ${sourceId.sourceName}`);
console.log(`is available from ${publisher.name}.`);
// Request to receive the source
await source.receive();
// Display the source on the UI
const videoElement = document.getElementById('video');
videoElement.srcObject = new MediaStream([source.videoTrack]);
videoElement.play();
});To publish your camera into a stream and listen to the available sources, call the connect function. Once connected, the SDK will trigger a series of publisherJoined and sourceAdded events that you must subscribe to in order to get the audio / video streams coming from the platform, and display them on your web page.
import { Publisher, Room, Source } from '@millicast/sdk-interactivity';
const room = new Room({
streamName,
streamAccountId,
});
room.on('publisherJoined', (publisher: Publisher) => {
console.log(`${publisher.name} joined.`);
});
room.on('sourceAdded', (publisher: Publisher, source: Source) => {
const { sourceId } = source;
console.log(`New ${sourceId.sourceType} source: ${sourceId.sourceName}`);
console.log(`is available from ${publisher.name}.`);
});
// Let the SDK handle the getUserMedia
const publishedSource = await room.connect({
publishToken,
publisherName,
constraints: {
// Set WebRTC Media Stream constraints
audio: true,
video: true,
},
});
// If you want to provide your own media stream, use the following code
const customPublishedSource = await room.connect({
publishToken,
publisherName,
mediaStream,
});
// Stop publishing sources
room.unpublish(publishedSource);
room.unpublish(customPublishedSource);To watch a stream, call the watch function. Once connected, the SDK will trigger a series of publisherJoined and sourceAdded events that you must subscribe to in order to get the audio / video streams coming from the platform, and display them on your web page.
import { Publisher, Room, Source } from '@millicast/sdk-interactivity';
const room = new Room({
streamName,
streamAccountId,
});
room.on('publisherJoined', (publisher: Publisher) => {
console.log(`${publisher.name} joined.`);
});
room.on('sourceAdded', (publisher: Publisher, source: Source) => {
const { sourceId } = source;
console.log(`New ${sourceId.sourceType} source: ${sourceId.sourceName}`);
console.log(`is available from ${publisher.name}.`);
});
await room.watch();To publish another source into a stream, call the publish function.
// Will publish another source
await room.publish({
publishToken,
constraints: {
// Set WebRTC Media Stream constraints
audio: true,
video: true,
},
});To publish a screenshare into the stream, call the getDisplayMedia function to get the screenshare stream. and the publish function.
import { SourceType } from '@millicast/sdk-interactivity';
// Prompts the user to select and grant permission to capture the contents
// of a display or portion thereof (such as a window).
const mediaStream = await navigator.mediaDevices.getDisplayMedia({});
const source = await room.publish({
mediaStream,
releaseOnLeave: true,
publishToken,
sourceType: SourceType.Screenshare,
sourceName: 'My Screenshare',
});
// Display the screenshare on the page
const videoElement = document.getElementById('screenshare');
videoElement.srcObject = new MediaStream([source.videoTrack]);
videoElement.play();The unit tests are built on Jest, to execute the tests, run the following command.
npm run testCreate distribution package:
npm run buildThe documentation is built on TypeDoc, to generate the doc, run the following command. You will find the HTML files in the docs folder.
npm run docsYou can also print the logs in the console and select the log level by using the following code.
import { Logger } from '@millicast/sdk-interactivity';
Logger.useDefaults({
defaultLevel: Logger.TRACE,
});