Skip to content

Create group session (host)#

To initiate a group session in XR Twin as Host, follow these steps:

1. Choose Simulation Project#

Launch XR Twin and select the simulation project that you want to share with other users. Ensure that the project is prepared and ready for collaborative use, and that it works correctly in a solo session.

2. Export Project#

Before creating the group session, export the project. This ensures that all participants have access to the exact same simulation file. Click here to find out how to export a project.

3. Send Project to Participants#

Share the exported project file (.xrproj) with the participants. You can send it via email, filesharing services, or any other preferred method.

Warning

Ensure that all participants, including yourself as the Host, are using the exact same simulation file. Any deviation in the simulation file will lead to failure in starting the group session.

4. Choose Project in Launcher#

Within the XR Twin Launcher, select the simulation project that you want to use for the group session.

5. Create Group Session#

Click on the Create group session button button_createGroupSession at the bottom right in the XR Twin Launcher interface.

6. Session configuration#

When creating a group session in XR Twin, you have the option to configure user settings in the Session login configuration popup.

To configure your user settings:

  • Session ID:
    A session ID will be generated automatically in the next step.
  • Username:
    You can change your username if necessary.
    By default, it's usually set to the name of your Windows session. This username will be displayed at the top of your avatar during the group session.
  • Device:
    You can select your preferred device type for the session: Desktop or VR.
    This choice determines your interaction mode within the virtual environment. You can change it later, in the Lobby.
  • buttonAbort Click this button to abort and return to the Launcher.
  • button_contextMenu currently unavailable.

After configuring the session, click on the Create session button.

7. Create Session ID#

An unique Session ID will be generated.

  • buttonJoinLobby Click this button to Join Lobby,
  • button_contextMenu currently unavailable.
  • buttonAbort Click this button to abort session and return to the Launcher.

Click the Join Lobby button to join the Lobby and wait for other participants to join.

8. Joining the Lobby#

Once inside the Lobby as Host, you can wait for your Guests to join the session. In Lobby popup, you can chat with them, send session information (ID), change your appearance and device. You can copy the session ID and send it to participants to join. They can use this information to access the session from their devices (see Join group session as Guest).

  • Session ID:
    Each participant must use these one to join the session.
  • Copy:
    Click on the Copy icon to copy Session ID to the clipboard.
  • Send:
    Click on the Send e-mail icon to open a mailto in your default mail client.
  • Project:
    Name and last modification date of the sharing project.
  • Chat:
    Feel free to send chat messages readable by all participants. Type your text and click on the Send icon . See Chat.

  • Audio:
    In XR Twin, the audio feature facilitates real-time communication among participants. See Audio.

  • To change your color or your device as Host, click on the three dot menu icon .

    • Choose Device:
      While in the Lobby, you have the option to change your device selection between Desktop and VR. This allows you to adapt your settings based on your available hardware or preferences.
    • Choose Color:
      Additionally, you can customize your guests experience by changing the color of your avatar within the Lobby interface. This helps distinguish between different participants and enhances visual clarity during collaboration. Each participant can change his or her own color.

9. Begin Collaboration#

Once all participants have joined the session, you can begin collaborating in realtime within the shared virtual environment.

  1. As Host, from your Lobby, click on the bottom right Start session startSessionButton button.
  2. Your simulation session starts.
  3. At the same time, the simulation session will begin for all of your Guests.
  4. Wait for scene and physics initialization. Some of your guests may be slower, depending on their computer configurations.
  5. You will see your guests' avatars in your local scene. In turn, each of your guests will see all the other participants in their local scenes.
  6. You can communicate with your guests via chat and/or voice.

As Host you have the privilege to interact with objects, other participants (the Guests) are viewers only.

10. End Session#

When the collaboration session is complete, you can choose to end the session by clicking on Stop Session button (top left).

Ending the session as Host will close the simulation for all participants.