Installing the conferencing system components

When you upload a custom region to Breakroom, you will need to install the conferencing system to achieve full functionality. Learn how to set up voice zones, navigation tools, and more.

Overview

In this walkthrough, we will take a completely blank region and set up the Breakroom conferencing system from scratch, with all the tools necessary to run an event. By following the steps below, you can install the conferencing system components in any custom region that you have uploaded.

The Breakroom conferencing system component source files are not available for individual distribution.

The core conference system

The core conference system components are included as part of the Breakroom Toolkit. While additional conferencing functionality can be added to your region (such as the Start Here UI and Emojis), for the purposes of this tutorial we are concerned with five key components:

Breakroom Combined Media Core

The Breakroom Combined Media Core is the backbone of the entire conferencing system, and is required for the conferencing system to function. It contains Breakroom's primary tools, such as voice chat, webcam and screen sharing capabilities, as well as the moderator controls.

Breakroom Camera System

The Breakroom Camera System controls all of the camera operations built into the conferencing system.

Breakroom Gestures Standard

The Breakroom Gestures Standard item contains all the gesture actions built into the conferencing system.

The Breakroom Navigation UI controls the navigation and teleport tools built into Breakroom.

Breakroom Auditorium 90

Finally, the standard 90-seat auditorium that features in several of Breakroom's default region templates is included for your use. This component is optional.

There is also a 200-seat auditorium object available, which you can find listed for free in the Breakroom Shop. For more information about locating the Auditorium 200 Seat object and purchasing it, please see our Starter Bundle documentation.

Installing the core components

To install the core components in an empty region, please follow the steps below. For more information about using the Region Editor or editing objects within the Region Editor, please consult the linked documentation.

Navigate to the empty region you want to edit.
Click on the Edit Region button located at the bottom of the screen. This will launch the Region Editor.
Click on the Inventory button located at the bottom of the screen. This will open the Inventory window.
Drag each of the core components from the Inventory window to the floor near your avatar. This will install them in the region.
1. Breakroom Combined Media Core
2. Breakroom Gestures Standard
3. Breakroom Camera System
4. Breakroom Navigation UI
When you are finished, click the Save button.

The positioning of the core components is not important. However, to keep things tidy, it is best practice to position them at 0/0/0. To precisely reposition an object, follow these steps.

While still in the Region Editor, click the Objects button located on the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Click on one of the four core components listed under the Room Floor heading (for example, the Breakroom Combined Media Core). This will launch the Inspector window for that object.
In the Inspector window, click the > arrow next to Transform component to expand it.
Locate the Local Position property. This property contains three fields. Set each field to the numeral 0, for a combined position of 0/0/0.
Repeat these steps for each of the core components.
When you are done installing and editing the core components, click the Save button, followed by the Close button.

After you save your work and close the Region Editor, you will notice that the conferencing system UI elements are now visible on your screen. This completes basic setup of the conferencing system. You can now edit and configure the conferencing system components to meet your needs.

Setting up the default auditorium

We have simplified the setup of some common areas. This includes a 90-seat auditorium with built-in camera and screen positions, as well as its own Presenter voice zone. You can install this item in your region by following these steps.

Navigate to the region you want to edit.
Click on the Edit Region button at the bottom of the screen.
Click on the Inventory button located on the bottom right to open the Inventory window.
Drag the Breakroom Auditorium 90 object from the Inventory window to the floor near your avatar. This will install it in the region.
Click the Save button.

You can now use the movement and rotation tools in the Region Editor to position the auditorium as necessary. When positioning is complete, click the Save button again to store your changes.

Editing the presenter seats

The 90-seat auditorium is configured to work "out of the box," with the conferencing system's communication and navigation functions built in. After positioning the entire auditorium object, the only thing you'll need to do is edit the presenter seats to meet your needs. In a Presenter zone, only the individuals who sit on the presenter seats will be able to turn on their webcams or share their computer screens.

To edit the presenter seats, follow the steps below.

While still in the Region Editor, click the Objects button located on the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Locate the Breakroom Auditorium 90 object. Click the > arrow to expand it.
Locate the Presenters object and click on it. This will launch the Inspector window for that object. Selecting this object will also isolate and highlight the presenter seats.

You can now move the presenter seats to your desired location by hand-keying values into the Transform component (as detailed above), or by using the Region Editor positioning tools. When you're happy with your changes, make sure to click the Save button.

Presenter seat hints

Testing position with a live avatar

If you sit on one of the presenter seat tags while the Region Editor is closed, then open the Region Editor while remaining seated, your avatar will travel with the presenter seat tags when you position them. This is a useful quality check to ensure that your avatar is facing the right way and isn't sinking into the floor.

Disabling unneeded seats

The conference system comes with 9 presenter seats. You can disable any seats you don't need by following these instructions.

Click on the Edit Region button at the bottom of the screen.
Click the Objects button located on the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Locate the Breakroom Auditorium 90 object. Click the > arrow to expand it.
Locate the Presenters object. Click the > arrow again to expand it.
Click the eye icon located to the right of any presenter seat you do not wish to appear in-world. In the example image above, seats six through nine have been disabled, leaving five presenter seats.
Click the Save button to store your changes.

Adding additional seats

You can add additional seats to a Presenter zone by installing one or more copies of the Breakroom Addon Presenters object. Learn more and access detailed instructions by visiting this page.

Restricting presenter seat access

You can also restrict presenter seat access to only users who have certain region-level or world-level permissions. Learn more here.

Setting up breakout rooms and voice zones

Breakroom's prefab breakout rooms and booths, like the 90-seat auditorium discussed above, come pre-equipped with seats, gestures, voice zones, and teleport UI functionality. These convenient virtual areas are designed to set themselves up; all you need to do is add them to your region using the Region Editor. You can learn more about installing and customizing prefab breakout areas by consulting this section of our documentation.

Custom voice zones are blank voice zones that can be placed wherever you like in your region. They can contain any items or regional features you choose, and can even be nested. You can edit the RoomFurniture component so they appear in the Breakout Rooms bar, or you can direct any button in the General Navigation bar to teleport users to a custom voice zone by following the instructions below.

The General Navigation bar offers guests the ability to teleport to different areas in your region with the click of a button. If seats are available in an area, teleporting there will also automatically assign users a seat.

The buttons, from left to right, are:

Button	Function
Auditorium	Teleports your avatar to the auditorium.
Information	Teleports your avatar to the region entrance or to a designated information booth.
Networking	Teleports your avatar to the designated lounge or networking area.
Floor	Teleports your avatar to the main "floor" of the event (e.g. vendor booths, game area).

Button

Function

Auditorium

Teleports your avatar to the auditorium.

Information

Teleports your avatar to the region entrance or to a designated information booth.

Networking

Teleports your avatar to the designated lounge or networking area.

Floor

Teleports your avatar to the main "floor" of the event (e.g. vendor booths, game area).

Note: The following instructions apply only to a General Navigation bar that you have installed in your own blank region. You cannot edit the General Navigation bars that come pre-installed in Breakroom's region templates.

You can remove one or more buttons from the General Navigation bar by following these steps.

Click on the Edit Region button at the bottom of the screen.
Click the Objects button located on the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Locate the Breakroom Navigation UI object. Click the > arrow to expand it.
Locate the Crowd Manager Navigation UI object. Click the > arrow again to expand it.
Locate the Canvas object. Click the > arrow again to expand it.
Locate the General Navigation object. Click the > arrow again to expand it.
You will see the General Navigation bar buttons (highlighted above). Click the eye icon located to the right of any button you do not wish to appear in the General Navigation bar.
Click the Save button to store your changes.
Click the Reset Zones button to reset the conferencing system.

If you like, you can change the location that each button in the General Navigation bar points to. This can be done either by repositioning the landmark objects within Region Editor, or by editing a voice zone's RoomFurniture component. Both sets of instructions are offered below.

Repositioning the landmark objects in Region Editor

Click on the Edit Region button at the bottom of the screen.
Click the Objects button located on the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Locate the Breakroom Combined Media Core object. Click the > arrow to expand it.
Locate the Crowd Manager Core object. Click the > arrow again to expand it.
Locate the Landmarks object. Click the > arrow again to expand it.
You will see the General Navigation bar landmark objects (highlighted above). Click on the name of the landmark you would like to move (e.g. Entrance).
Physically reposition the landmark object within the region using the Region Editor tools, or by entering the appropriate values in that object's Transform component, as detailed above.
Click the Save button to store your changes.
Click the Reset Zones button to reset the conferencing system.

Editing the RoomFurniture component

Using this method, you can point any button in the General Navigation bar to a custom voice zone or a prefab breakout area of your choice.

Click on the Edit Region button at the bottom of the screen.
Click the Objects button located on the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Locate the voice zone or prefab breakout area you want to edit, and click on it. The Inspector window will launch.
In the Inspector window, click the > arrow located next to the RoomFurniture component to expand it.
Locate the Zone Name property. Type in the name of the General Navigation bar button you would like to point to this voice zone (e.g. Auditorium, Entrance, Networking, or Floor).
Click the Save button to store your changes.
Click the Reset Zones button to reset the conferencing system.

If you use this method, the landmark object associated with the Zone Name (Auditorium, Entrance, Networking, or Floor) will be overridden. There is no need to manually disable it. However, if you would like to use that landmark object again, you will need to rename any custom voice zones or breakout areas using its name.

Breakroom's conferencing system contains multiple navigation tools.

The General Navigation bar, located in the top left corner of the screen, makes use of landmark objects built into the conferencing system. By editing the position of these landmark objects (or by assigning their identifying names to custom voice zones), users can teleport to those locations with a single click. This editing process is described above.
The Breakout Rooms bar, located in the top right corner, displays a teleport button for each voice zone that includes the prefix "Breakout" in its Zone Name property. (For example, Breakout 1, Breakout 2, etc.) When you add a prefab breakout area to a region, a teleport button will automatically appear in the Breakout Rooms bar. You can also edit the Breakout Rooms bar manually. You can find instructions for doing so here, and more technical details here.

In addition to these navigation bars, there is a third: the Areas of Interest panel.

This panel is visible on the right side of the screen when activated. The Areas of Interest panel can teleport users to any voice zone that has the "Zone Visible" option enabled in its RoomFurniture component. Zones already linked in either the General Navigation bar or Breakout Rooms bar will be ignored by the Areas of Interest panel. This makes it a flexible solution for offering additional teleport options to your users.

When speaking about these three navigation tools in aggregate, two new options emerge for advanced region configuration:

Removing navigation tools from the region entirely.
Activating and customizing the Areas of Interest panel.

To enable or disable the three individual tools that make up Breakroom's navigation system, follow these steps.

Click on the Edit Region button at the bottom of the screen.
Click the Objects button located at the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Locate the Breakroom Navigation UI object and click on it. The Inspector window will launch.
In the Inspector window, click on the > arrow next to the RoomFurniture component to expand it.
You will see three properties listed under the RoomFurniture component:
1. Navigation Breakouts: This refers to the Breakout Rooms bar.
2. Navigation General: This refers to the General Navigation bar.
3. Navigation Others: This refers to the Areas of Interest panel.
If you want a menu to appear in your region, type "yes" into the corresponding field. If you want to remove a particular menu from your region, type "no" into the field.
Click the Save button to store your changes.
Click the Reset Zones button to reset the conferencing system.

The Areas of Interest panel

If you choose to make the Areas of Interest panel visible to your users, you can follow the instructions below to populate it with clickable teleport buttons.

Click on the Edit Region button at the bottom of the screen.
Click the Objects button located at the bottom right. This will launch the Objects window.
In the Objects window, click the > arrow located beside the Room Floor heading to expand it.
Locate the breakout area or Breakroom Voice Zone object you want to include under Areas of Interest, and click on it. The Inspector window will launch.
In the Inspector window, click on the > arrow next to the RoomFurniture component to expand it.
There are two key properties listed under the RoomFurniture component that you will need to edit:
1. Zone Name: This is the name of your area, and the name that will appear in the corresponding teleport button in the Areas of Interest panel. (For example, "Coffee Bar.")
2. Zone Visible: This property governs whether the zone is listed under the Areas of Interest panel. Type "yes" into the field if you want the zone to be added to the panel. Type "no" into the field if you want to remove the voice zone from all panels.
Click the Save button to store your changes.
Click the Reset Zones button to reset the conferencing system.