Action Manager in the Space Editor

Joschka
Have more questions? Submit a request
Updated

Content


    This article shows you the many possibilities of the Action Manager, which allow you to flexibly design automated and interactive actions in Spaces.

    The Action Manager is currently still a beta feature and must be activated separately. If you are interested, please contact your representative at rooom or our sales team.

    How are task groups and tasks created in the Action Manager?

    1. In the Space Editor, you can now switch to the Action Manager at the bottom left:
    2. In the left menu, you can create task groups and tasks and in the right menu you can edit task groups and tasks.

      For task groups, you can only change the name.
      For tasks, you additionally have the following options:
      • Enable/disable task
      • Set the maximum number of executions for a task under "Max. Executions". If the field is empty, executions are unlimited (default).
      • Set triggers
      • Set actions

     

    Triggers – What initiates an action?

    Every task starts with one or more triggers:

    • Initial: Once at the start of the viewer.
    • Object collision: When two defined objects touch.
    • Avatar collision: When an avatar hits an object.
    • Objects clicked: When clicking on a 3D model.
    • Key press: Pressing a key such as letters, numbers, or Enter.
    • Variable changed: When variables (text, number, bool) change.

    Additionally, you can add conditions to control the triggering more precisely. These conditions are available:

    • equal – applies when the value exactly matches the comparison value
    • not equal – applies when the value differs from the comparison value
    • greater than – applies when the value is larger than the comparison value
    • greater or equal – applies when the value is at least as large as the comparison value
    • less than – applies when the value is smaller than the comparison value
    • less or equal – applies when the value is at most as large as the comparison value

    For example, you can set the condition that the trigger is only activated when Score greater than 10 is met.

     

    Actions – What happens when a trigger occurs?

    As soon as a trigger is activated, all actions stored in the Action Manager are executed. In addition to their specific parameters, every action has two general settings: 

    • Global/Local:
      You can define whether the action should be executed globally or locally. If you execute an action globally, it is synchronously visible or effective for all visitors. A locally executed action only affects the current user and is not visible to others.
      It is especially important when and how the trigger activates the action: For global actions, you should avoid them being started multiple times or unintentionally for all users at once. Therefore, carefully consider the combination of trigger, conditions, and execution type.
    • Delay:
      With the Delay parameter, you can define how many milliseconds (1000 ms = 1 second) after the trigger the action should be executed. This allows for time-coordinated sequences or staggered reactions. 

    The following actions are available in the Action Manager:

    Absolute Transformation

    Sets the position and/or rotation of an object to fixed values.
    Options: Position (X/Y/Z), Rotation (X/Y/Z), Scale (X/Y/Z)

    Note:
    Whenever an action affects an object in the Space, the object is selected by its name. Therefore, it is particularly important to give your objects clear and unique names in the Space Editor so you can target them in actions later.

    You can also select multiple objects at once and assign them to an action. In this case, the action will be applied to all selected objects simultaneously.

    Relative Transformation

    Changes the current position and/or rotation of an object by specific values.
    Options: Position (X/Y/Z), Rotation (X/Y/Z), Scale (X/Y/Z)

    Object State

    Changes one or more states of an object, e.g., visibility, collision, emissivity, or mobility.
    Options: Visibility (on/off), Collision (on/off), Emissivity (on/off), Mobility (on/off)

    Sound

    Plays a sound clip or controls its state.
    Options: Sound file, State (start, stop, pause, toggle), Spatial, Volume (0–100), Loop (yes/no), Distance

    Notification

    Displays a text message directly in the interface. 

    Options: Title, Text, Variant

    Notes:

    1. Only executable locally. For global notifications, use a global variable as a trigger for the notification.
    2. Insert variable: To insert a variable into the text, you can enter a $ sign followed by the name of the desired variable. Example: $doorstatus

    Teleport Avatar

    Moves the user’s own avatar to a defined position.
    Options: Target position (X/Y/Z), Target rotation (X/Y/Z)

    Note: This action only affects the user’s own avatar – even if it is defined as global. To teleport all avatars simultaneously, use a global variable (e.g., teleportAll) with a Variable Change trigger and combine it with local avatar teleport actions.

    Object Animation

    Starts or stops an animation on an object.
    Options: Animation name, State (start/stop)

    HTTP Request

    Sends an HTTP request to an external API.
    Options: URL

    Variable

    Interacts with a defined variable.
    Options: 

    set: Set to a specific value

    add: Add value

    subtract: Subtract value

    toggle: Invert state (e.g., true ⇄ false)

    Was this article helpful?
    1 out of 1 found this helpful
    Share

    Comments

    0 comments

    Please sign in to leave a comment.