Breakroom Video Player

The perfect tool for sharing training videos, highlighting sponsors, or creating dynamic event backdrops. Read on for more information about setting up and using the Breakroom Video Player.

Overview

The Breakroom Video Player allows users to access live or pre-recorded video content on demand. Object Owners and users with appropriate World- or Region-level permissions can also configure playback options and add a splash screen that will be displayed when the video player is not in use.

In your Inventory, you'll see the Breakroom Video Player represented by this icon:

For help installing the Breakroom Video Player, please review our information on using the Region Editor.

In order for this Toolkit object to work, you must have the Breakroom conference core components installed in the same Region. If you have uploaded a custom Region, you will need to install these components manually prior to setting up this object.

Breakroom Video Player user controls

Pictured: The Breakroom Video Player control bar.

Users can control any Breakroom Video Player using the buttons located in the bottom control bar. Videos are displayed on a per-user basis, not streamed openly to the Region as a whole.

Control bar button	Function
Play	Plays the video for the user who clicks it.
Pause	Pauses the video for the user who clicks it.
Stop	Stops the video for the user who clicks it.
Zoom In / Zoom Out	Allows the user to focus on and away from the screen.
Settings	Only available to Object Owners and users with appropriate permissions.

Setting up the Breakroom Video Player

Highlighted: The location of the Breakroom Video Player gear icon.

The Breakroom Video Player control panel is only accessible to the Object Owner and users with appropriate World- or Region-level permissions. To access it, click on the gear icon in the bottom control bar.

Adding a splash screen image

Pictured: The Breakroom Video Player settings.

Splash screen image settings are the very first thing you'll see in the Breakroom Video Player control panel. You can either choose a splash image from your Media Library, or upload a new splash image from your computer.

To set a splash screen for your video player, follow these steps:

1. Locate the Breakroom Video Player object you want to edit.

2. Click on the gear icon to open the Breakroom Video Player control panel.

   1. To choose an image you've already uploaded to Breakroom, click the Image Library button. This will open the image picker. Click on the image you want to use.

   2. To upload a new splash image from your computer, or click the Upload New Image button. This will open a standard file picker on your computer. Locate the image you want to use, click on it, and then click the Open button.

3. Your selected image will display in the preview window. When you're satisfied, click the Save and Close button.

Entering a video URL

Pictured: The video URL and video settings in the Breakroom Video Player control panel.

To enter a video URL, follow these steps:

1. Locate the Breakroom Video Player object you want to edit.

2. Click on the gear icon to open the Breakroom Video Player control panel.

3. Paste your video URL into the Video URL field.

4. Click the Save and Close button.

Video playback options

The Breakroom Video Player control panel also allows you to customize the way videos are played. You can loop a video, mute a video until users interact with the player, and more.

To edit the video playback options, follow these steps:

1. Locate the Breakroom Video Player object you want to edit.

2. Click on the gear icon to open the Breakroom Video Player control panel.

3. Click the ON or OFF button located next to each video playback option.

4. Click the Save and Close button.

Video playback setting	Function
Auto Play	If set to ON, video will begin playing automatically when users enter the video player collider zone, and will stop when they exit the zone.
Loop Video	If set to ON, video will replay continuously.
Silent Mode	If set to ON, video will play with muted audio until a viewer clicks the Zoom In button.
Post FX	If set to ON, will turn off various graphics settings within the video player collider zone that could distort the video or on-screen text.
Pops Out	If set to ON, video player screen will "pop out" to user screen when users enter the video player collider zone. The offset and scale of this pop-out screen can be customized by entering values into the associated fields.

Editing the Breakroom Video Player collider zone

Pictured: The Region Editor, with a Breakroom Video Player object selected. The transparent green box indicates the size and location of the collider zone. In the Objects window, you can see that the collider zone object is nested within the Breakroom Video Player object.

Several advanced features and video playback options are triggered when an avatar enters the Breakroom Video Player collider zone. The size and position of this collider zone can be customized using the Region Editor.

The instructions provided below presume an advanced working knowledge of Breakroom. Please consult our documentation if you need help installing and positioning virtual objects, or editing the RoomFurniture component.

To edit the Breakroom Video Player collider zone, follow these steps:

1. Open the Region Editor by clicking the Edit Region button at the bottom of your screen.

2. Locate the Breakroom Video Player object you want to edit. Click on it to highlight it in the Objects window.

3. In the Objects window, click the > arrow to the left of the Breakroom Video Player object to expand it. Then click on the Collider component.

4. Using the Region Editor tools or the Transform component, move, rotate, and resize the collider to meet your specifications.

5. When you are satisfied, click the Save button to store your changes.

Tips for best performance

Picured: A Breakroom Video Player set up in the Desert Island region template.

• Breakroom supports many common video formats, such as MP4, HLS, and YouTube videos.

• Breakroom does not currently support videos hosted on Vimeo.

• For best performance, we recommend hosting your video as an MP4 file on a cloud server (such as Amazon AWS).

If a YouTube video is DRM-controlled or monetized, you will not be able to stream it through the Breakroom Video Player. Please be aware that YouTube may automatically apply DRM restrictions to a video if it detects the presence of copyrighted materials (such as background music). If the video you want to use is DRM-controlled or monetized, you may still be able to play it using the Breakroom Web Browser. Please note that playing a video on the web browser object offers a different experience, and that Breakroom cannot track video analytics through the Web Browser object.