Video streaming

This scene shows you how to stream video into a scene

It includes de Scene Admin Smart Item, which allows admin users in the scene to perform a number of special tasks. These include:

• Playing videos from URLs
• Streaming live
• Sending UI announcements to all players in the scene
• Activating any Smart Items in the scene
• Banning players from the scene
• Adding other users as admins

Stream to your scene

The simplest option is to use the Admin Tools smart item. The admin panel includes a video player section where they can control anything related to videos. See The documentation for more information

Use free software like OBS or StreamYard to capture your microphone and camera or screen. Once you published your scene, in the Scene Admin UI you'll find the necessary information to configure your app and start streaming into your scene.

Choosing a hosting option

Instead of streaming through Decentraland's free architecture, you may want to use an alternative.

One option is to use a hosting provider like Vimeo or Livepeer Studio where you pay a fee to the provider to manage all the streaming infrastructure. The other alternative is to set up your own server, using free software but paying for hosting on a platform like Digital Ocean. All these options have pros and cons for different scenarios. You should evaluate what's best for you taking into account your needs, technical skills and budget.

Managed hosted

Vimeo Pro (or higher):

Pros:

• Should be able to support unlimited concurrent users
• Is extremely easy to set up
• Costs $20 USD a month
• Offers analytics dashboard

Cons:

• Only allows you to stream pre-loaded videos, no live streaming.
• In this modality, players see the video start when each arrives to the scene. What they see may be out of sync with each other.

Vimeo Premium

Pros:

• Should be able to support unlimited concurrent users
• Is extremely easy to set up
• Allows for live streaming
• Offers analytics dashboard

Cons:

• Costs $75 usd a month

Livepeer Studio:

Pros:

• Easy to set up
• Free 1000 minutes/month video processing (transcoding and uploading videos)
• Allows for live streaming

Cons:

• No analytics dashboard
• Streaming of pre-loaded videos (VODs) currently requires using Studio API
• After 1000 free monthly minutes, costs are calculated as:
  • $0.005 USD/min for transcoding
  • $0.015 USD/GB for delivery

Self-hosted

Set up own server on Digital Ocean

Pros:

• You can do streaming or any modality you want
• Can cost as little as $5 USD a month (this option supports up to roughly 50 viewers)
• Relatively nice UI, if you have a strong technical background

Cons:

• Requires high technical skills to set up everything manually
• The cheap option is not recommended for +50 viewers, more expensive options may be on par with Vimeo Premium.

Note: For many Decentraland Foundation events, we use Amazon Web Services hosting. This option is more robust, but also more expensive and less friendly to set up.

Set up Vimeo Pro

This is the simplest option, but doesn't allow for live streaming.

1. Create a Vimeo account if you don't have one. Then upgrade to any of the paid tiers offered there.

2. Upload a video to one of your folders.

3. Open the video's settings, and select Advanced.

4. Pick Distribution, and scroll to the bottom to Video file links. Copy the last one of these links, the one labeled HTTP live streaming.

Note: The other available links on specific resoltuions often don't work when streamed into Decentraland. Always use the HTTP Live streaming. This option adjusts the quality of the video dynamically depending on the player's connection, leading to an optimal result. Note that this link is different from performing a streaming of a live event: players will each see the video from start to finish, without necessarily being in sync with what each other is seeing.

5. Paste the link into your scene, replacing the placeholder link on the VideoPlayer component.

Tip: If you intend your video to loop, make sure you set the loop property on the VideoPlayer component to true in your scene. Otherwise the video will play just once for each player.

Set up Livepeer Studio

The first step is to create a Livepeer Studio account.

Live streaming

1. While signed in, go to the Streams section
2. Click the + Create stream button
3. Give your stream a name in the prompt. Click Create stream button when finished.
4. For broadcasting (via broadcasting software like OBS), use the the RTMP ingest URL and Stream key found on the newly created stream page.
5. For playback in a video player, use the Playback URL url.

Pre-loaded video (VOD) streaming

Functionality to upload asset directly in Studio dashboard coming in Q3 2022

Custom Server on Digital Ocean (Advanced)

This is the cheapest option, but is significantly harder to set up than the others.

See ADVANCED-SETUP.md for detailed instructions for how to deploy a server, configure it, and install all the necessary command-line tools.

---

📂 Deployment

Once customized, you can:

1. Deploy the house to your Decentraland World or Lands in Genesis City.
2. Share it as an open house for visitors.

---

📝 License

This template is intended for free use and adaptation within the Decentraland ecosystem.
Feel free to fork, remix, and personalize it for your gallery or project.