Do you have any questions about the offer or the setup?
The XR-EASY team will answer all your questions by email. You can fill out the form below to send us an email
You can try XR-EASY with four already into VR converted test models but to test the additional features (automatic CAD-to-VR converter and teleport points) we can send you a license that works for 14 days.
Below we describe comprehensively how HAMMES|XR-EASY works.
For VR professionals, we also offer quick guides for download:
After installation via remote maintenance or by your IT specialist, XR-EASY becomes an add-on to the room planning software. Using the 3D export function of the planning software, you can transfer the planned model into the virtual world at the push of a button.
Your workplace computer usually serves as the host and starts the cloud session in the so-called desktop mode. Any number of VR headsets and other computers that are equipped with the XR-EASY software and are connected to the internet can take part in this session.
The VR headset is charged via the USB-C port with the included charging cable and power plug. Please schedule regular charging in advance to ensure an uninterrupted VR experience.
The controllers are shipped with two 1.5 V AA batteries each. Please keep spare batteries on hand. Alternatively, rechargeable batteries can be used. Caution: It is not possible to charge rechargeable batteries in the controllers.
To change the battery, pull the cover in the direction of the printed arrow.
When purchased from our hardware partner, the VR headset is delivered ready-to-use with preconfigured software in so-called kiosk mode. First, buyers must familiarize themselves with the devices – VR headset and controller – and how they work.
Requirements
⇒ For more information go to Starting a VR session
Desktop mode refers to the use of XR-EASY on a standard Windows computer without VR headset. This mode differs fundamentally in action possibilities, options, and purpose from using XR-EASY with a VR headset. Desktop mode is primarily used to prepare sessions and host the VR session (with a stable internet connection). If only one person is in the VR headset, this session can be accompanied via the desktop. However, the professional will also notice planning errors on the desktop.
⇒ For more information go to Desktop Mode
The “play area” defines the boundaries within which users of the VR headset can move freely. Outside these boundaries, the black-and-white image of the outdoor cameras is displayed.
When leaving the play area, they will therefore see the real environment, which should prevent collisions with obstacles (walls, furniture, stairs) and thus injuries.
There are two modes to choose from:
Custom mode
Quick mode
Note
(Screenshots follow each description)
Note
Manual adjustment: Under”2. Check…” click on “Adjust >” with TRIGGER Button ➔ Place controller at floor level ➔ Press TRIGGER Button (2)
Before XR-EASY is ready for use, the local WLAN/WiFi network must be connected. Proceed as follows:
Click on the WiFi icon with the TRIGGER Button (1)
Select WLAN/WiFi network ➔ click on your network name with the TRIGGER Button (1)
The integration of XR-EASY into the normal workflow with the HAMMES|Software is straightforward via the entries within the software:
Certain textures cannot be transferred to VR. In this case, a notice will appear indicating which textures are affected. Except for not including these textures, however, nothing changes in the overall process.
This section describes joining while using the same WiFi network as the session host.
For joining the VR session from a different network, go to “Main menu” ⇒ “Can I join a coop session manually?”
The name of the host (1) can be changed in the “Settings” of coop sessions.
Refer to “General functions” ⇒ “How can I join a coop session?”
If you encounter problems during session joining, please check Troubleshooting / Other:
⇒ “My model is not loaded into the VR session. What is the reason for this?”
⇒ “The window for automatic session entry does not appear. What is the reason for this?“
Once a VR user enters the session, they are automatically placed at the center of the model.
To change the start position, the teleport points function must be used.
Once a model is exported from HAMMES to XR-EASY, an .XVR file is created. This file can also be loaded directly into XR-EASY for viewing on the desktop, creating teleport points or hosting a new coop session.
The .XVR file is placed by XR-EASY on the folder “*\XR-EASY 3.x.x\3D Models\Name-of-the-offer”, which then be loaded into XR-EASY without having to use the planning software.
To create a VR (coop) session, please follow the instructions on subsequent entries in the “Desktop Mode” chapter:
⇒ “How can I start XR-EASY manually?”
XR-EASY can also be used as a VR tool without the implementation by a planning software. All that is required is a CAD file in OBJ or FBX format. This file can be loaded manually into XR-EASY and is automatically converted into our XVR format.
The following entries describe the process for starting XR-EASY manually and loading files in detail:
⇒ “How can I start XR-EASY manually?”
The main menu and the hand menu are used to select functions and settings. The functions and menus in VR can be controlled using three different gestures.
If the play area is large enough, the user can move freely within the VR session. For larger distances and small (or quick mode) play areas, the teleport and teleport points functions are useful.
By default, the teleport function is active. If teleport points are set up by the host, the teleport points function becomes active and the teleport function is deactivated.
More information about both options can be found in the following entries.
The teleport function allows the user to freely reposition in the VR session.
For an instruction and setup guide on Teleport Points, go to:
The Teleport Point function allows for restricted user repositioning in the VR session.
Files that are stored on the headset can also be loaded manually into a session. However, this does not work in coop mode. If the user is already in a coop session, the session will be exited when a new file is loaded.
⇒ To manually load a coop session, go to “Can I join a coop session manually?”
It is possible for the user to manually connect to a running coop session. This is necessary, for example, if the host and user are not on the same network.
⇒ Refer to: “How do I share my XVR file with other participants?
In the Settings menu, you can switch between English and German. Furthermore, data collection tools can be switched on and off here.
For how to look up the session ID in desktop mode, go to the following entry:
All participants of a Coop session can communicate with each other using the session-internal voice transmission.
The session can be left via the logout button after confirmation.
The user has no restrictions when moving around in the VR space while in desktop mode. Moving around in desktop mode is done with keyboard and mouse.
⇒ “What can be configured in the settings?“
General settings can be configured and information can be obtained in the menu:
To load a file manually, please proceed as follows:
The user can also manually connect to a running coop session:
⇒ Refer to: “How do I share my XVR file with other participants?
Connectivity to R3DT Cloud must be established ➔ ✅ Connected (3)
After creating a session, the session ID can be looked up on the pop-up window (1) and in general by hovering over the cloud (2):
With a left click on the cloud, the session ID is automatically copied to the clipboard and can be pasted as usual via CTRL+V.How to look up the session ID in VR can be found under the following entry:
The session can be saved in desktop mode. This saves placed teleport points and changes of the model position by the Move All function.
All participants of a coop session can communicate with each other using the session-internal voice transmission.
Advanced settings can be configured in the settings windows in desktop mode:
If no teleport points have been set by the host, the center of the model is defined as the starting position.
To define a different start position, at least one teleport point must be set. However, this disables the free teleport function. With the use of teleport points, the VR user is automatically set to the first teleport point when entering the VR session.
The center point of the model can be within an object (e.g. table, cabinet) or a wall. In this case, a VR user would be directly inside said object or wall when entering the VR session. This can lead to a negative experience for the customer. Due to this, the starting position should be identified beforehand and possibly changed by using the teleport points.
Teleport points are fixed positions in the model between which VR users teleport. This restricts VR users in their freedom of movement, and thus gives the host the ability to determine which spots in the model are relevant.
When entering the session, the VR user is automatically positioned at the first teleport point.
If no teleport points were set by the host, the center of the model is defined as the starting position.
The center point of the model can be within an object (e.g. table, cabinet) or a wall. In this case, a VR user would be directly inside said object or wall when entering the VR session. This can lead to a negative experience for the customer. Due to this, the starting position should be identified beforehand and possibly changed by using the teleport points.
Once position and viewing angle of the teleport points have been configured, the changes can be accepted or rejected via the window at the bottom:
Teleport points can also be set up during a coop session. This can help if the client wants to view the model from a certain position or perspective.
Once set up, the VR user can teleport to the new points.
Teleport points are created, deleted and set in the setup mode.
⇒ Refer to: “Teleport points“
Alternatively, teleport points can also be deleted via the list under Tools ➔ Positions.
⇒ Refer to: “Which setting options are available?” – List of all teleport points
There are generally no restrictions on participating in a coop session as long as certain requirements are met.
More information can be found in the following sections:
⇒ Participation in VR: “Can I join a coop session in VR manually?”
⇒ Participation in Desktop Mode: “How can I join a coop session?“
XR-EASY creates an XVR file when exporting a model from the planning software under the following file path:
“*\XR-EASY 3.x.x\3D Models\name-of-offer\name-of-offer.xvr”
The file can be copied and shared with other participants.
Subsequently, the shared XVR file must either be placed in the “*\XR-EASY 3.x.x\3D Models” folder, or alternatively selected manually when joining the coop session.The file must be loaded onto the VR headset before joining the coop session:
The file not being loaded after an established connection to the VR session can be caused by various factors. A distinction should be made between three cases:
1. The file transfer remains at 0% or stops halfway through.
2. The loading process is aborted.
3. An error message appears.
First case:
The automatic file transfer only works if the VR headset and the PC with the planning software are in the same network.
If a very large model is loaded, it may take several minutes before the file is transferred. This could result in the first case, and it should be waited to see if it is due to the increased loading time.
First or second case:
If the loading indicator still shows 0% even after several minutes, or if the loading process stops, another cause can be assumed:
Putting down the VR headset can lead to an abortion of the charging process, since the standby mode of the headset is initiated after a short time
Leaving the play area also leads to an abortion of the file transfer, since the VR headset turns on the external cameras and thus automatically leave XR-EASY
Often a combination of the two previous causes occurs, e.g. if the VR goggles are put down outside the game area during the loading process
The network connection must be stable at all times: any loss of connection can also cause the file transfer to stop
Any of these causes will require the connection to be re-established. For this purpose XR-EASY must be restarted.
⇒ Refer to: “How do I end the session?”
Third case:
If an error message appears, the instructions given should be followed.
Occasionally, certain router models and/or network protocols may lead to connectivity problems, which then cause problems with the automatic session admission. Rebooting the systems can help in this case. We recommend proceeding in the following order and retrying automatic admission after each step:
Compliance with certain hygiene standards is required for professional customer relations. If the VR headset is used by different people, the surfaces of the headset and controller should be cleaned before an exchange.
The face cushion can be removed for cleaning or replacement due to traces of usage:
It is extremely important to avoid negative experiences by the customer. Therefore, the following points should be considered:
The attached client instruction guide can help discussing these points:
It is important to clarify that the virtual space is not about visuals, but about spatial conditions and thus aspects of ergonomics and proportion.
The virtual display of textures and light effects in the model will be much more impressive with a custom rendered image.
We recommend setting up teleport points – before using them with customers – for the following reasons: