Learn how to set up a theater domain.
If you’re planning to host an event in virtual reality, you’ve come to the right place! This tutorial will walk you through creating and setting up a domain with a customizable theater that meets your needs. At the end of this tutorial, you’ll be able to:
Before we dive in, let’s take a look at the customizable theaters available in High Fidelity.
Hosting an event in High Fidelity has never been simpler - welcome to Zaru, your personal theater for any of your virtual reality event needs. While you’re free to create your own theater or environment for hosting events, we created Zaru as an easy starting point for you to host events. Zaru has a wide variety of features geared towards hosting a great event:
All you’ll need to bring - is the show!
High Fidelity’s distributed platform enables almost limitless server configurations that you customize for your hosting needs. For smaller events (up to 10 avatars), a single instance of a server OS would be enough, as long as it’s a relatively recent computer. You can also set up a virtual machine hosted with cloud services providers such as Amazon, Azure, or Digital Ocean. For large-scale events, you can determine if you need more powerful hardware, or setup a distributed system with each assignment client running on a different server.
You can setup your server by either:
We have hosted events with 100+ users by using a distributed server model for assignment clients, with virtual machines running Ubuntu on Amazon Web Services. You can check out the details on the size of each machine used for our event on February 10th here.
Once you have successfully setup your domain, you’ll need to configure access settings to edit the contents of your server from the Interface client. Follow the instructions in Setup Your Domain to Build in High Fidelity to configure your server settings and add users to your domain with edit privileges.
By default, a High Fidelity Sandbox will contain the tutorial environment and a builder grid. The tutorial content is centered around the location 0, 0, 0 and the builder grid is centered around 0, -200, 0.
Here's how you can delete the tutorial content:
Your avatar will be floating, but we’ll change that in just a minute.
You can import the entire Zaru theater, as well as the ground, zoning lights, and models, to your domain. Once you have a copy of the objects in your domain, you can customize them to personalize your theater.
Import Zaru to your domain:
When you import the JSON file, you’ll get a zone for the theater, all of the necessary models for the theater itself, lights, and a builder grid base. These are all separate, so take care if you relocate objects to align everything the way you want.
The Zaru theater file contains a specific zone called SKY/Inside, which has a set of properties for the interior of the theater. You can change settings in here to specify some permissions for users, including whether or not they are given the ability to fly.
When you host events in the theater environment, you’ll probably have performers or presenters on stage and you’ll want to update the audio in the environment accordingly. High Fidelity supports audio settings in the form of attenuation zones. These zones can be used to create different volume levels for people around your domain. For our theater, we want audio from the stage to be louder and prioritized over the audience audio, so that people in the back of the theater can hear, and so that the audience doesn’t talk over whoever is on stage.
Find the location of where your stage, audience, and microphones are in your domain. Make a note of the coordinates on the corners of each area where you want to change the attenuation settings - you’ll need to update these in the server settings of your domain.
Find your avatar’s coordinates by:
or by hitting the "/" button and reaing the "position" in the middle column.
Audio Zones are defined by a start and end coordinate value for each of the three axes in-world. An example of how you might choose to define your zones is illustrated in the diagram below. In the sample, the X and Z values are defined along their respective axes, and the Y start and end would be the value of the floor and ceiling. To add audio zones to the Microphone stands in Zaru, create a smaller region within the audience.
Our Content Team tech lead Liv has made a handy tool for audio zone bounding boxes you can find here.
The way to use it is to create a cube in world and size and align it to where you want the boundaries of the audio zone to be. Run the script, click on the cube. The x,y,z coordinates will appear in the scripts window. Use those to define the zones in the domain settings page.
Once you have the coordinates of your audio zones:
If you are having trouble with your Audio Zones check for the following:
Save your audio settings and test them until you find a combination that works for you. Other audio settings that you may want to experiment with are:
You can set custom access controls depending on the type of events you plan on hosting in your space. If the event is limited to certain people, you’ll want to create an access list in your server settings to add specific user accounts.
The People Access List (PAL) is a handy tool for moderating your event once it has begun. You can use the PAL by selecting the People tab and viewing everyone in the domain. Admins of your domain have additional silence and ban permissions to remove ill-behaving visitors. You can also manage blocked users on your server settings page.
To authenticate and make your domain easier for users to find, you can purchase a place name that connects to your domain.
In addition to security and audio settings, there are several other tools you can use to plan your events. You can: