Skip to main content

​
Overview

The Teleport User To action instantly repositions the learner’s camera viewpoint to a new location and orientation in the 3D scene. This guides the learner’s perspective to the right place at the right time without requiring them to navigate manually.

​
When to Use

  • Guide perspective during steps — Automatically move the learner’s view from a wide overview to a close-up of a specific component
  • Reposition for each new step — Reset the learner’s viewpoint at the start of each training phase
  • Focus attention — Direct the learner’s gaze to the next action point automatically
  • Ensure visibility — Guarantee the learner can see critical details from the optimal angle

​
Parameters

ParameterTypeRequiredDescription
Target PositionVector3 (X, Y, Z)YesThe 3D coordinates where the camera will teleport to (distance in meters from scene origin)
Target RotationVector3 or QuaternionYesThe direction the camera will face (pitch, yaw, roll or quaternion orientation)

​
Example

Move learner to examine a control panel 
Action: Teleport User To
Target Position: [2.5, 1.5, -3.0]
Target Rotation: [0, 45, 0]
The camera instantly moves to coordinates (2.5, 1.5, -3.0) and faces 45 degrees along the Y axis, pointing at the control panel. Return to overview position 
Action: Teleport User To
Target Position: [0, 5, 5]
Target Rotation: [-30, 0, 0]
The learner returns to a bird’s-eye view of the entire scene.

​
Tips

  • Use in onEntry to position the learner before instructions appear
  • Combine with Show Panel to display instructions alongside the new viewpoint
  • Record multiple waypoints as reference points: save the camera position/rotation for key areas of your scene
  • Transition between positions smoothly by:
    • Teleporting to an intermediate position briefly
    • Using small position increments across multiple steps
    • Letting the learner manually navigate between teleport points for spatial awareness
  • Test camera positions on mobile devices — ensure nothing is cut off at smaller screen sizes
  • Disable Self Teleport — Lock the learner in place after you teleport them
  • Set Interactable Objects — Restrict interactions to objects now visible in the new viewpoint