Skip to main content

​
Overview

The Load Scene action loads a 3D environment from your organization’s scene library. Load the initial scene before actions that need its objects. Later steps can reuse that environment until another Load Scene action replaces it.

​
When to Use

  • Initialize the environment: load the scene used by the first training step.
  • Change environments: load a different scene when the training moves to a new location or task.

​
Parameters

​
Configure and Load a Scene

1

Add the action

Select the step and open On Entry. Add Load Scene before actions that need the environment, such as highlighting or moving scene objects.
2

Choose the scene and version

Open Scene, search for the environment by name, and select it. Review Source Version after the available versions load, then select the required version. Check this field again whenever you change the scene.
3

Set loading and display options

Enable Wait Until Complete. Choose Display Mode for the target device. Leave Initial Position (Optional) blank unless you need to change the trainee’s starting position.
4

Load the scene in the editor

Click Load Scene at the bottom of the action’s settings. Wait for loading to finish before selecting objects for subsequent actions or transition events.
The editor’s Load Scene button currently loads the scene’s active version. Source Version is saved on the training action. Save and start training playback to verify the selected version and its object references.

​
Initial Position in Web Trainee App

The X, Y, and Z values are added to the scene’s saved InitialUserPosition marker when the scene loads. For example, 1, 0, 0 shifts the trainee’s starting point one meter along the world X axis from that marker. Leaving the values blank or using 0, 0, 0 adds no offset in web playback. If the scene has no InitialUserPosition marker, the web app uses its default starting point and does not apply this offset. Test the starting position in the trainee app used for delivery.

​
Important Notes

  • Scene replacement: Loading a different environment replaces the current scene. Configure following object actions and events against objects in the new scene.
  • Scene reuse: Steps that continue in the same environment can reuse the loaded scene. Add Load Scene where an environment needs to be loaded or changed.
  • Repeated loads in Web Trainee App: Re-running the same Load Scene action can be skipped when that scene instance is already loaded. Repeating the action is not a guaranteed way to reset the scene to its saved state.

​
Practical Example

Scenario: Trainees progress through a warehouse, a factory floor, and an equipment room. Use three scene assets available in your library.
1

Create the environment steps

Create steps named Warehouse, Factory Floor, and Equipment Room. Configure the training to enter Warehouse first.
2

Configure Warehouse

Add Load Scene to Warehouse’s On Entry actions. Under Scene, select your warehouse scene, review Source Version, enable Wait Until Complete, and choose Opaque. Leave Initial Position blank to use the scene’s saved starting point in web playback.
3

Configure Factory Floor

Add Load Scene to Factory Floor’s On Entry actions. Select your factory-floor scene and its Source Version. Enable Wait Until Complete and choose Opaque.
4

Configure Equipment Room

Add Load Scene to Equipment Room’s On Entry actions. Select your equipment-room scene and its Source Version. Enable Wait Until Complete and choose Opaque.
5

Connect and test the steps

Configure transitions from Warehouse to Factory Floor, then from Factory Floor to Equipment Room. Save and start the training. Confirm that each step loads the intended environment and starting position, and that actions placed after Load Scene find the correct scene objects.
When checking a scene version, start a fresh training run. Verify its object references as well as its appearance, especially after changing the selected scene or version.
Place Load Scene before scene-dependent actions and enable Wait Until Complete. With waiting disabled, later scene actions in normal web playback can start while the new scene is still loading.