Intro to Dolby.io streams

Streams are in-world screens that display a live stream media source running through Dolby.io streaming service. Dolby.io streams provides sub-second latency, broadcast-quality color and sound, and end-to-end encryption.

Adding a stream

To get started you'll want to add a stream item into your space. Open your items panel and select the Stream option. Then click Add stream.

Stream properties

A stream screen item will drop into your space. You'll see a few options on your expanded properties panel that will allow you to modify your screen:

• Show 3D screen: You can toggle this off if you want streams to be audio-only.
• Curve: Add curve to your screen in either direction.
• Aspect ratio: Select between 16:9 and 4:3 aspect ratio to fit your media content.
• Audio volume and Audio attenuation: Change the distance users can hear the audio from, and the overall volume.

Screensharing to your stream

The easiest way to push content to your stream items is through in-app screensharing.

You can screenshare while in a huddle session. While in huddle and screensharing, click the Cast to 3D screens button - this will push your screenshare to your stream items.

Read more about to huddle through the docs.

🚧

Please note that currently you are unable to share your audio using this feature.

Add an external source to your stream

You might need to add content that is more complex than a screenshare, or add content that isn't dependent on you being in the space at the same time.

There are multiple ways to add an external source to your Dolby.io stream. Some of these methods are provided directly from Dolby.io, and others are available from Odyssey.

Some methods will involve you providing a Stream Name and a Stream Key to your streaming software. You can find that information within your Space Settings > Stream tab.

Odyssey Streamer chrome extension

We built a chrome extension so that you can screenshare from your browser, while not needing to be in a huddle session, or even in the space at all.

To get started, download the Odyssey Streamer chrome extension.

Once you add the chrome extension, you can pin it to your extensions bar by pressing the Extensions button (looks like a puzzle piece) on your browser bar, and clicking the pin button next to Odyssey Streamer.

Open up the Odyssey Streamer extension from your toolbar and you'll see a place to add your stream information and show the Start Stream button (which shows up on the lower-right of your screen).

Press the Stream button on the lower-right of your screen and you'll start screensharing.

OBS

OBS is a good approach if you have a more complex broadcast requirement that you can't achieve with a simple screen-share, like managing multiple input sources or overlaying content.

At the moment, in order to use OBS with WebRTC you must use a modified version that has been extended to interface with the Dolby.io Real-time Streaming servers. You can download the latest version from our repository HERE.

To begin, first download and install the OBS-WebRTC client to your PC or Mac. Then go to the OBS settings panel and click to open it.

From the "Controls" menu click on the Settings button which will open the Settings panel. From here, click on the "Stream" option. Then from the "Stream Type" dropdown, select "Millicast WebRTC Streaming Platform".

Fill out the Stream Name and Publishing Token with the info from Space Settings.

Change the Codec to VP9.

📘

Currently Stream items only support the VP9 codec.

That's all you need. Hit the Start Streaming button and you should be pushing out your source live.

Seeing your stream

Once you've started a stream from one of your sources, you'll see it render automatically to your screens in-world. You don't have to do anything else to turn them on in-world. When you want to stop the screens playing, simply stop the source you chose.