Triggers & Actions¶
Triggers & Actions feature allows to make your experience interactive for your visitors.
Watch this tutorial to get an overview of how to animate objects:
Triggers¶
Triggers are elements to set an interaction that will trigger an Action on something.
They can't be used alone, they must always be linked to at least an Action.
To add a Trigger to a scene element:
-
Select the scene element.
-
Use the "Add Trigger" button in the element menu.
-
Choose a Trigger in the list. Set its options if needed.
Triggers types¶
Tap¶
The Tap Trigger is used to trigger an Action when the visitor taps on an element.
Hover¶
The Hover Trigger is used to trigger an Action when the element is hovered.
"Hover" has different meanings depending on the device:
-
Headsets and goggles: the cursor is over the element.
-
Touchscreen devices: the finger touches the screen and goes over the element.
Technical issue with skinned models
Note that there are some issues on SparkAR and XR View regarding the tap and hover triggers applied to skinned models. They may not be accurately detected due to some technical conflicts. We always try to find the best compromise to provide you with the best experience possible and hope we'll find a way to improve it soon!
View related¶
Enter View
The Enter View Trigger is used to trigger an Action when an element enters the visitor's view, meaning their gaze or screen is oriented toward the element whereas it wasn't before.
The Action will be triggered once, and each time the element enters the visitor's view.
Note that an appearance isn't considered as an entering in the view, for example when an element is displayed in front of the visitor at the launch of the Experience.
Leave View
The Leave View Trigger is used to trigger an Action when an element leaves the visitor's view, meaning their gaze or screen is no longer oriented toward the element.
The Action will be triggered once, and each time the element leaves the visitor's view.
In View
The In View Trigger is used to trigger an Action when the visitor looks out an element, meaning the element keeps being in their gaze or screen.
A continuous Action is triggered as long as the element remains in view.
Zone related¶
The Zone is centered on its related element by default.
Its size (vertically and horizontally) can be adjusted thanks to handlers displayed when a zone related trigger is selected.
Enter Zone
The Enter Zone Trigger is used to trigger an Action when the visitor enters the zone, meaning their view device is inside the zone whereas it wasn't before.
The Action will be triggered once, and each time the visitor enters the zone.
Note that an appearance isn't considered as an entering in the zone, for example if the visitor spawns in the zone at the launch of the Experience.
Leave Zone
The Leave Zone Trigger is used to trigger an Action when the visitor leaves the zone, meaning their view device is no longer inside the zone.
The Action will be triggered once, and each time the visitor leaves the zone.
In Zone
The In Zone Trigger is used to trigger an Action when the visitor is inside the zone, meaning their view device keeps being inside the zone.
A continuous Action is triggered as long as the visitor remains in the zone.
Actions¶
Actions are elements to applied to a scene element to perform a one-time (Disrupted Action) or looping action (Continuous Action).
They can be:
-
applied alone to an element: they will be automatically triggered at the beginning of the Experience.
-
linked to a Trigger to be applied only when the Trigger will be performed.
Some Actions can be used together on the same element, some can't. See Actions types section
To add an Action to a scene element:
-
Select the scene element.
-
Use the "Add Action" button in the element menu.
-
Choose an Action in the list. Set its options if needed.
Actions types¶
Levitate¶
Levitate is a Continuous Action to make elements smoothly float in the air.
Go to its Properties to custom:
-
The height of the levitation
-
The duration of the round trip in seconds (from the default position, to the top, to the bottom and then back to the default position)
Pulse¶
Pulse is a Continuous Action to make elements smoothly scale bigger and smaller.
Go to its Properties to custom:
-
The minimum % of the default size
-
The maximum % of the default size
-
The pulse duration in seconds (from the default size, to maximum %, to minimum % and then back to default size)
Spin¶
Spin is a Continuous Action to make elements spin round and round.
Go to its Properties to custom:
-
The revolution duration (360°) in seconds
-
Reverse the direction of rotation
-
Choose the axis to base the rotation on: local (the element) or global (the scene world)
It can't be used with Face visitor Action as their behaviors aren't compatible.
Face visitor¶
Face visitor makes the element orientation follow the visitor's position.
It can't be used with Rotate Action as their behaviors aren't compatible.
Transform (2 keys)¶
Transform Action allows you to create a transform animation between 2 keys:
-
The Start key: the default element style.
-
The End key: the element with new position, scaling and/or rotation properties.
Select the "Set end key" button, then transform the element (move it, scale it and/or rotate it) to create the end key.
An animation will be created between the 2 keys.
In the Properties, you can choose the duration of the animation and for it to be played:
-
Once: in one way, only once (by default).
-
Boomerang: back and forth, once (compatible with Loop).
-
Loop: repeatedly as long as the action is active, it's then Continuous (compatible with Boomerang).
Later we'll provide a more complex Transform Action to create and edit several keys... Stay tuned!
Play¶
The Play Action can be used on a:
-
Sound: to play a sound.
-
Video: to play a video.
-
Animated glTF: to play a choosen animation on a glTF (3D object) element. Note that the animation has to be available in the glTF file, you can't make it in Minsar.
You can choose to play the element in loop or once.
Open Scene¶
The Open Scene Action allows the visitor of your experience to navigate from the current scene to another one.
You can choose the scene you want to open in the Properties of the Open Scene Action.
Open URL¶
The Open URL Action can be used to open a link with the default web browser of the device. Visitors will then automatically leave the Experience to do so.
You can edit the URL in the Properties of the Open URL Action.
Phantom link
You can also use it to trigger what we call a Phantom link.
When you enable this option, the URL won't open the web browser but trigger the specified link.
This is useful to communicate with smart home devices (i.e. turn on/off lights) or to gather some information for analytics. It then might not be visible to the visitor.
Hide / Reveal¶
Hide action is used to make an element disappear from the experience. It won't be visible or palpable.
You can edit the way it fades out in the Properties.
Reveal action is used to make an element appear in the experience.
You can edit the way it fades in in the Properties.
Link between Triggers & Actions elements¶
To link a Trigger to an Action:
-
Use the "Link to" button in the Trigger menu.
-
Select the Action element (on the same scene element or another one in the scene) you want to link it to.
You can also make it from an Action to a Trigger.
You can't link a Trigger to another Trigger, or an Action to another Action.
To remove a link:
-
Select it by taping on it, then delete it.
-
Select the trigger or the action, then hit the "Unlink from" button of the menu. Then select the action from which you want to unlink the trigger.
To replace a trigger :
- Select the trigger you want to replace, then select the "Replace" button of the menu. Choose the new trigger you want instead.
Link visual¶
When a Trigger and an Action are linked, a line is displayed between them.
You can see an animation on the line for you to understand the direction of the interaction.