3.0 KiB
| sidebar_position |
|---|
| 1 |
Reactive Components
Reactive Components are components which apply some effect to your avatar based on the active state of their GameObject (and its parents), or Menu Item enabled states. This allows you to build up simple toggles, adjust blendshapes as you change your outfit, and more - without needing to manually set up any animations.
The following reactive components are currently available:
- Object Toggle - controls the active state of other game objects
- Shape Changer - modifies blendshapes on a target renderer
- Material Setter - changes materials on a target renderer
General rules for reactive components
In general, reactive components apply some kind of effect when they are active. A reactive component is considered active when:
- Its GameObject, and all parents, is active in the scene hierarchy.
- If the reactive object is on the same GameObject as, or a child of a Menu Item, the Menu Item is
selected.
- Note that only the first parent Menu Item is considered (parent Submenus are ignored).
After building your avatar, reactive components respond to the following:
- Animations which change the state of GameObjects
- Object Toggles which influence the active state of other reactive components
- Menu Item selections
You may also select the "Invert condition" option; in this case, the effect of the component is applied when any of the above conditions is not true.
Priority rules
If multiple reactive components are active at the same time, and their effects conflict (e.g., one tries to turn off a game object, one tries to turn on a game object), the component lowest in the hierarchy takes precedence.
Reaction timing
Reactive components responding to the change of a GameObject's active state will do so after a one frame delay. When the game object is being deactivated, the game object's deactivation will be delayed by one frame to happen at the same time. See Shape Changer for more information on why this is the case.
If one reactive component controls the state of another reactive component, then there will be a one frame delay between each reactive component triggering. The delay will be applied to each reactive component individually, so if you have A -> B -> C, and A is turned off, the timing will be as follows:
- Frame 1: Nothing happens (A's disable is delayed)
- Frame 2: A is disabled (B's disable is delayed)
- Frame 3: B and C are disabled at the same time.
Preview system
The effect of reactive components on mesh visibility is immediately reflected in the editor scene view. However, this has some limitations; in particular, it considers the current active state of objects, and the "default" state of Menu Items, but does not consider the effect of Object Toggles on other reactive components. To see the full effect of reactive components, you must enter play mode.