MAGES Device Manager

The MAGES Device Manager is located under Packages/MAGES-Core/DeviceManager.

Assets of Importance

Asset Name

Description

MAGESControls.inputactions

This asset, found in the Resources folder, utilizes Unity’s Input System to connect input bindings (buttons) to events. It is a crucial component for managing input interactions.

MAGESInputController.asset

This asset, also in the Resources folder, connects the input system with the rest of the MAGES SDK. It assigns references to InputActions (e.g., Select, Deselect) to MAGES events.

Note

Here are the respective Paths:

Path: Packages/MAGES-Core/DeviceManager/Resources/MAGESControls.inputactions

Path: Packages/MAGES-Core/DeviceManager/Resources/MAGESInputController.asset

MAGESControls Configuration

Upon opening the MAGESControls.inputactions file, you will encounter the following UI:

../../_images/nxtdevicemanagercontrols.png

It consists of 3 different sections:

Section

Explanation

Action Maps

The categories of the different Actions. You can create a new Action Map or delete an existing one.

Actions

The Actions that are included in the selected Action Map. You can create a new Action in the Action Map selected or delete an existing one.

Action Properties

The properties of the selected Action.

If you want to learn more about the Unity’s Input System you can check it out in the Unity’s Documentation

Some worth mentioning Actions are the following:

Actions

Explanation

Select and Activate:

  • They represent the selection or the activation of the XR Controllers.

  • They can be found in the LeftHand Interaction or in the RightHand Interaction Action Maps, which are associated with the left and right XR Controllers accordingly.

  • Each one is also associated with a Selection or an Activation Intensity Action accordingly, which has to do with the intensity of the press of the selection or the activation button on the XR Controllers
../../_images/nxtdevicemanagerselect.png

Actions

Explanation

Snap Turn and Smooth Turn:

  • The Snap and Smooth Turn Actions represent the snap or the smooth rotation of the player.

  • They can be found in the LeftHand Locomotion or in the RightHand Locomotion Action Maps, which are associated with the left and right XR Controllers accordingly.
../../_images/nxtdevicemanagerturn.png

Actions

Explanation

Change Height and Move

  • The Change Height Action represents the vertical movement of the player as opposed to the Move Action representing the horizontal movement of the player.

  • The Change Height Action can be found in the RightHand Locomotion Action Map and the Move Action can be found in the LeftHand Locomotion Action Map.
../../_images/nxtdevicemanagermove.png

MAGESInputController Configuration

The MagesInputController asset can be customised to link events to the Actions inside the MAGESControl Input System.

../../_images/nxtdevicemanagesinputcontroller.png

You can also enable/disable specific categories of Events, specifically:

  • Generic Events

  • Locomotion Events

  • Interaction Events

Camera Manual

The camera mode settings in MAGES-NXT are located in the MAGES Panel/Hub Settings, specifically under the Device Manager module. Follow the steps below to access and configure the camera mode:

  1. Navigate to MAGES Panel/Hub Settings.

  2. Locate the Device Manager section.

  3. Find the Camera Mode setting.

../../_images/nxtdevicemanagerplugin.png

Available Camera Modes

  • UniversalXR:

    • Description: UniversalXR is the currently supported mode, serving as the generic VR mode.

    • Note: Upon selection, it may list missing dependencies. Install any missing dependencies as prompted.

XR Plugin and VR SDK Configuration

  1. After installing the XR Plugin, proceed to select the specific VR SDK you intend to use.

  2. Navigate to Edit > Project Settings > XR Plugin Management.

../../_images/nxtdevicemanagerpluginmanagement.png

  1. Select the desired VR SDK (e.g., Oculus VR SDK) from the available options.

../../_images/nxtdevicemanagerselectSDK.png

Camera Configuration in MAGES-NXT

In MAGES-NXT, cameras and controllers are configured automatically at runtime. There is no manual configuration required. The system handles the setup dynamically, ensuring seamless integration with the selected camera mode and VR SDK.