MRx User Guide

Beta v1.4.11

Contact Us for Assistance

MRx is currently in closed beta, please contact us if you are interested in participating.

 

The main components of MRx are:

  • MRx CONSOLE APP.
    This is a Windows app installed on your Win10 laptop/PC to manage assets and simulations as well as launch sessions.

  • MRx APP.
    This is the HoloLens app installed to your HoloLens devices from the MRx Console.

  • SESSION MANAGER.
    This is a Windows interface launched from the MRx Console for each session and is used to manage sessions from your laptop/PC.

How It Works

TO CREATE A SIMULATION:

Content iconLaunch MRx Console on your Win10 laptop/PC:

  1. Upload assets you want in your simulation.
  2. Launch a session.

Content iconLaunch MRx on your HoloLens:

  1. Join the session.
  2. Use ‘gaze and drop’ to create simulation.

TO DEPLOY AND RUN A SESSION:

Content iconLaunch MRx Console on your Win10 laptop/PC:

  1. Launch local session for selected simulation or share it for remote sessions.
  2. Host or join remote sessions.

Content iconLaunch MRx on your HoloLens:

  1. Join the session.
  2. Collaborate on the simulation.

What You Need

Please consult your IT dept if your devices and/or laptop is managed through an MDM or if you do not have administrative privileges.

  1. Windows 10 laptop/PC with admin privilege.
  2. Microsoft HoloLens 2 headset(s) with admin privilege.
  3. Wireless network router (optional for local sessions only).
  4. Internet connection and Microsoft account (for remote sessions only).

NETWORK REQUIREMENTS.

 

Local Sessions

Ports: 7779, 7780, 7781

 

Remote Sessions

Ports: 7779, 7780, 7781, 443, 3478; 50000+

Installing MRx

  1. Click on the link from the invitation email to download the MRx Console installer file. Click on the downloaded file to install MRx Console on your Windows 10 desktop.
  2. Ensure ‘Use Developer Features’ and ‘Device Portal’ in your HoloLens settings is set to ON.
  3. Set up your device portal access credentials.
  4. Register your HoloLens devices (see Registering Devices section below).
  5. Click ‘Devices’ on the left panel of the MRx Console.  Click ‘Install’ next to the registered device.

Registering Devices

Ensure your HoloLens is turned on and connected to the same network SSID as your laptop / PC.

 

We recommend assigning static IP address for your devices.

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Devices’ on the left panel.
  3. Click ‘Add Device’.
  4. Enter the device name, IPv4 address and portal access credentials.
  5. The device will appear on the list. When registration is successful, the device status will be shown as Online and Credentials OK.

Uploading Assets

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Assets’ on the left panel.
  3. Enter a name for your asset group and click ‘Create Asset Group’.
  4. Click ‘Add Asset’ to upload assets into the asset group.

SUPPORTED FILE FORMATS.

 

3D models: glb

2D images: jpg, png

Video: mp4

Preparing 3D Assets (.glb).

If your 3D modeling software does not export to .glb, we recommend exporting your model in a format supported by Blender (e.g. .fbx, .obj).

 

  1. MRx model ingestion supports one material, texture and normal per mesh. Transparency is supported.
  2. Triangulate to optimize polygon count. Use per–vertex normal and UV.
  3. Set origin to Center of Mass (Volume). Recenter model by setting Location X, Y, Z to 0. You may also want to set Rotation angle so model is aligned horizontally to the X axis.
  4. Check that Scale is set to 1.00.

COORDINATE SYSTEM.

 

Content icon

Creating Simulations

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Click ‘Create Simulation’.
  4. Enter simulation information and select the asset groups you want to use in your simulation. Click ‘Next’.
  5. Click ‘Launch Session’. This launches the Session Manager window.
  6. Launch MRx on the HoloLens to join the session
  7. Select new or last saved space on the Session Manager.
  8. Place the anchor on the ground, air tap to lock in place.

Running Local Sessions

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Click the ‘Launch Local Session’ for the desired simulation.
  4. Click ‘Launch Session’. This launches the Session Manager window.
  5. Launch MRx on the HoloLens and join the session.
  6. Select new or last saved space on the Session Manager.
  7. Place the anchor on the ground, air tap to lock in place.
  8. Launch MRx on other HoloLens to join the session.
  9. When all participants are in the lobby, click ‘Start’ on the Session Manager.

Sharing Simulations (for Remote Sessions)

A Microsoft account will be required.

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Select the simulation to upload and click the ‘Upload Simulation’ icon button.
  4. Click the ‘Uploaded Simulations’ tab. Log in panel may appear if you are not signed in.
  5. Click the ‘Share Simulation’ icon for the desired simulation.
  6. Input participant emails to send download link.

    Invited participants will receive an email with a link to download the simulation.

Hosting Remote Sessions

A Microsoft account will be required.

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Click the ‘Uploaded Simulations’ tab. Log in panel may appear if you are not signed in.
  4. Click the ‘Host Remote Session’ for the desired simulation.
  5. Click ‘Launch Session’. This launches the Session Manager window.
  6. Launch MRx on the HoloLens and join the session.
  7. Select new or last saved space on the Session Manager.
  8. Place the anchor on the ground, air tap to lock in place.
  9. Launch MRx on other HoloLens to join the session.
  10. When all participants are in the lobby, click ‘Start’ on the Session Manager.

    Remote participants will join the session at the lobby and appear as avatars.

Joining Remote Sessions

A Microsoft account will be required.

MRx is installed on laptop/PC and HoloLens.

  1. Click on the link in the invitation email and click ‘Download Simulation’ on the webpage.
  2. Launch MRx Console on your laptop/PC.
  3. Click ‘Join Sessions’ on the left panel.
  4. Click the ‘Join Remote Session’ for the desired simulation.
  5. Click ‘Launch Session’. This launches the Session Manager window.
  6. Launch MRx on the HoloLens and join the session.
  7. Select new space on the Session Manager.
  8. Place the anchor on the ground, air tap to lock it in place.
  9. Launch MRx on other HoloLens to join the session.
  10. When all participants are in the lobby, click ‘Start’ on the Session Manager.

    Remote participants will join the session at the lobby and appear as avatars.