May 31, 2022
Note: This tutorial includes visuals of the old UI. Updates follows soon.
In this VR Builder tutorial, you will learn how to use the Step Inspector, VR Builder's second main graphical user interface, to define steps for your VR application in Unity. In detail, you will learn how to work with behaviors, transitions, and unlocked objects in the Step Inspector.
Before you get started, please make sure you already understand the basics and how to work with the Workflow Editor. If you haven't done so already, check out the tutorial on the Workflow Editor. For this tutorial, we expect that you already know how to create and select a step with the Workflow Editor.
The Step Inspector automatically appears directly after a step is selected. If you haven't done so already, create a step in the Workflow Editor and select it. The Step Inspector appears in a new window. If not, this window already exists and you might have added it to your layout. We recommend adding the Step Inspector window to a high area on the right, for instance together with the Unity Inspector.
Now that everything is set up, we can start defining a step!
In the Step Inspector, you can set the name and description of a step as well as define what happens during each step. In addition, you can set the conditions to be fulfilled to trigger a transition. You can also manually unlock objects so that they become interactable during a given step.
Below the Step Name and Description, the Step Inspector has three main areas to represent each of these capabilities, labelled Behaviors, Transitions, and Unlocked Objects.
Before going into detail about each of these, please note that the Step Inspector supports undo and redo as well. You can either click on Edit->Undo / Edit->Redo or use the hot keys Ctrl+Z and Ctrl+Y to make use of them for each of the actions that will be explained in this chapter.
The Step Name and Description are used to make the process clearer. The Step Name will also be used to label the step in the Workflow Editor so it's good to keep it brief and descriptive. The Description field can be used for a longer version to help your colleagues or future self to understand what's happening in this step without going through all the details.
In this section, we focus on how to use the Step Inspector for defining behaviors. To learn more about how behaviors work in general and how to use each of the provided behaviors individually, refer to the documentation for VR Builder. You will also find the link to this documentation when pressing the help icon next to the Add Behavior button:
Select sub-tab Behaviors to get access to the following features.
To add a behavior, press the Add Behavior button. This will open a flyout from which you can select any of the available behaviors. The core package already offers a lot of choices and is grouped into the categories Animation, Environment, Guidance, and Utility. If you installed add-ons as well, this collection can get even bigger.
Once you have selected a behavior, attributes and object references for this behavior are displayed.
Fields can be filled by selecting the field and typing valid values. When you exit a field, your input is automatically parsed to a valid value. For instance, alphabetic characters are discarded if a number is required. For referencing a Game Object, you can either click on the Game Object Selector next to the field or drag'n'drop a Game Object from the scene hierarchy.
After you reference a game object, VR Builder automatically checks if it already contains all necessary components. If not, VR Builder offers you to add them automatically. You can do so by pressing Fix it. Note that by removing the connection the added components will not automatically be removed. However, they will be removed if you undo pressing the Fix it button.
You have already learned how to work with transitions in the Workflow Editor. In this section we will cover how you can work with them in the Step Inspector, as well. Some functionalities are redundant, in which case we will point this out. Some other functionality can only be used in either of them.
Select sub-tab Transitions from the Step Inspector for the following subsections.
Pressing Add Transition will add a new transition on the bottom of the list as does the corresponding + icon in the Workflow Editor. You can delete transitions by clicking on the trash bin icon next to them.
This will cause the same effect as deleting them from within the Workflow Editor. This also means that if you delete the last transition from the Step Inspector, one transition will remain but it will be emptied.
By pressing the arrow icons, you can reorder the transitions. Apart from the aesthetical aspect, transitions are evaluated top to bottom. This means that if several conditions are fulfilled at the same time, then the topmost valid transition will be the one that triggers.
Note that you can change the target step to transition to only from the Workflow Editor. The order of the transitions you can only change from the Step Inspector.
Working with conditions works the same way as working with behaviors. Please check our documentation on how to use the Step Inspector for defining conditions. To learn more about how conditions work in general and how to use each of the provided conditions individually, refer to the documentation for VR Builder.
We also have detailed tutorials on some of the most important conditions, for instance snap zones. More tutorials on conditions will follow soon!
Select sub-tab Unlocked Objects.
First, you will see a list of automatically unlocked objects in this step. Objects are automatically unlocked if they are required for behaviors or conditions in this step. In the example above, this list is empty. Below, you can manually unlock objects to make them interactable in this step, as well.
In this VR Builder tutorial you have learned how to use the Step Inspector. Now you are ready to create your own VR processes. Dive deeper into which behaviors and conditions are available for VR Builder. Therefore, check our tutorial on snap zones!