Dolby.io streams
A placeable screen that displays live streamed media, running through Dolby.io.
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
andAudio 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.
Updated 6 months ago