How to Broadcast in Dashboard

Log into your Dolby.io Real-time Streaming account and select Live Broadcast from the left menu. Here you can provision and manage all of the streaming tokens for your account.

1588

Create a basic Token

Your Dolby.io Real-time Streaming tokens are used for authenticating both publishers and viewers. It provides authentication to allow publishing a live stream to your account, and manages viewer permissions.

Start by creating a token using the Add (+) button.

540

Give your token a label and one stream name and hit ok.

To learn more about creating tokens in detail see Creating a Publishing Token

Using the Quick Action Menu

Each token item has a quick action menu that provides various options: Disable/Enable token, Delete Token, Online Broadcaster and Token Settings.

1590

Below is an explanation of these options:

Disable/Enable token

This allows you to quickly disable the token to prevent anyone from using it. Note: this will not disrupt any feed that was broadcasting live at the moment it was set.

Delete Token

Simply deletes the selected token. Keep in mind that once your token is deleted it will not be recoverable, so it is important to be careful when using this feature.

Online Broadcaster

Allows you to broadcast a live feed quickly and easily from the dashboard.

Token Settings

Opens the Token Management interface to view the details and options of your token like delete, stream names, labels, record and much more.

1338

Now select the "Broadcast" button to enter the Online Broadcaster interface and begin your live broadcast.

Broadcaster Interface

The broadcaster interface is a light weight online broadcaster which allows you to instantly begin broadcasting your live stream to your global audience.

The main menu interface at the bottom provides these primary functions: Microphone and Camera input selectors, Start/Stop broadcast button, recording button, settings, picture in picture, and share button.

The Mic and Cam input selectors allow you to select between the microphone and camera inputs that are active on your computer. You can alternatively mute the audio, or disable the camera as well.

The record button allows you to record your live broadcasts. You can toggle the record feature only when you are not broadcasting live. If you are in a live broadcasting, you must stop the broadcast first to toggle the button.

Located at the bottom right corner of the broadcaster interface are a few menu options that allow you to manage your live feed.

The settings allows you to modify media settings, adjust the video display, and report issues with the Publisher.

The picture in picture button allows you to toggle picture-in-picture viewing.

The share button opens up a panel that provides links to the viewer for sharing your stream, as well as information about your stream.

636

The share panel provides a link to a hosted viewer that you can share, as well as iFrame code for you to embed the player on your website. You can adjust and change the iFrame code by clicking the Customize button which will load an interface that allows you to manipulate the iFrame code to customize the hosted player.

636

The settings button opens another panel that allows you to manipulate camera quality, capture size, frame rate and aspect ratio.

640

You can use these controls to tune the stream for quality, size and even codec (eg. h264, VP9 or AV1) which can provide certain benefits and capabilities. These adjustments can be very helpful when streaming to a wide variety of devices and network conditions. For example if the broadcaster is streaming from a very bandwidth-limited location, you have the ability to lower the quality, capture-size and framerate to maintain a smooth stream. Alternatively, you can activate the Simulcast feature which will tell the system to make available 3 alternative quality streams for users that require lower bandwidth settings to gain speed and fluidity. To do this, simply click the checkbox for Simulcast at the top of the Settings Panel.

Note: Currently our browser-based simulcast feature is supported only when publishing via Chrome, however the stream can be viewed with any browser. Only the broadcaster requires using Chrome.

To use the stereo audio feature with your Dolby.io Real-time Streaming streams, you must use a stereo-enabled microphone. In addition, echo cancellation must be disabled while using the stereo setting. Doing this may cause an audio feedback loop so it is best practice to use headphones while listening to your stream to prevent echo.

Some of the settings can only be changed before you start your broadcast, and others can be done while broadcasting.

Note: Some capture settings like width and height can disable your camera if the camera cannot support the requested dimensions. The browser will throw an over constrained error. To learn more see Mozilla Docs - OverconstrainedError or W3C Docs - Overconstrained Object.

Also floating over the video element is a small indicator that displays a status of your broadcast.

Status descriptions:

LIVE

You are currently broadcasting live.

READY

You are currently not broadcasting.

LIVE + REC

You are currently broadcasting live and recording.

Feel free to use this broadcasting interface as much as you like or build and host your own.

Hosting your own broadcaster makes it easier for you to provide your users with their own broadcaster interface that you can control and manage based on your own requirements. To assist you, please read the Web SDK getting started and download the sample files.

Broadcasting with multisource

With the multisource feature, you are available to publish different independent feeds (each one identified with a different source id) under the same stream, this enables multiple audio and video tracks from different sources to be available to viewers.

🚧

Enable multisource to your token

For using multisource streams, your account must be allowed to use the multisource feature and the Publish Token must have the multisource flag enabled

658

To publish different sources you have to open one broadcaster for each source with the same Token and StreamName.

Then you have to open the media settings modal and configure each source. If you dont turn on the MultiSource toggle or leave empty the Source ID input then that broadcaster will stream the Main source. For the other broadcasters you have to activate the Multisource toggle, and type a name in the Source ID input.

After this simple configuration you will be able to stream multiple sources using the same Token and Stream Name

🚧

Main source

If you don't set a 'Main' source the viewer doesn't go to start the stream until a source has been selected