Immerse

Immerse Sessions

πŸ“˜

Immerse Spaces are now Immerse Sessions!

To improve scalability and integration with enterprise IT systems, Immerse Spaces have been significantly upgraded. Learn more about them here.

Immerse Sessions tab

Immerse Sessions are more flexible than Spaces which preceded them. Session owners have more control over content access permissions, whether they are multi or single user and also their expiration date.

  • Invitations - Sessions to which you've been invited (via email)
  • My Sessions - Active Sessions owned by you
  • History - Sessions you've previously created which have now expired
  • Legacy spaces - Spaces created using earlier versions of the Immerse Platform - please read earlier documentation for an overview.

πŸ“˜

If the new Session sub-tab is not visible to you please contact [email protected].

Creating an Immerse Session

  1. Starting on the My Sessions sub-tab, click (CREATE SESSION), which will reveal the New Session panel

New Session panel

To create a new Session:

  1. Enter the name for your Session
  2. Attach a Scene to your Session
  3. Choose a geographical location where the Session will be hosted. By default this will be geographically closest to you.
  4. Add participants via their email address This will trigger a customised email which will be delivered to each participant, detailing their Join URL and PIN, if they are joining via Oculus Quest.
  5. Session Settings

   Restricted to invitees / Any user
Your Session can be made available to any user (who knows the URL), or restricted to specific, invited participants.

   Single user only / multiple users
The Immerse Platform supports collaborative Sessions which can be joined by multiple users concurrently, however this is not always required. By designating a Session "Single user only", multi-user capability is disabled.

   Expiring / Permanent
By default, a newly created Immerse Session expires within 7 days. By selecting "Permanent" the Session will never expire will be available indefinitely.

Session details

1 Session details, including name and expiration date
2 Get PIN reveals a unique 6-digit number, to be used when joining the Session on Oculus Quest
3 Join Session now
4 Show, edit, delete and resend invitations to invited participants
5 Copy or delete the Session

Joining an Immerse Session in a web browser

🚧

Only Google Chrome is currently supported for WebGL / browser access

  1. To join an Immerse VR Session, access the join URL (in the form vr.immerse.io/#########) using the Google Chrome browser.

(Immerse browser Sessions require use of the laptop microphone and audio, so these are checked before each session. )

🚧

If Chrome reports that vr.immerse.io wants to use your microphone, you must select [Allow] or you will be unable to join

After access has been granted, an option to join via [Web] or [VR] will be offered - choose [Web]

Wait a moment whilst the WebGL content is downloaded.

Desktop browser view

The Immerse Session web user interface

  1. VR user view
    View the Immerse Scene through the eyes of any VR participant (Session owner only)
  2. Static camera view
    View the Immerse Scene through third person cameras defined in Unity (Session owner only)
  3. VR view
    Select to view immersive / 3D content (Session owner only)
  4. Reset scene
    Perform a hard reset, ejecting all users from the Session (Session owner only)
  5. User list
    View Session participants, check whether they are speaking and mute/unmute them (if Session owner)

Joining an Android Session

Getting the APK onto the device

Due to licensing restrictions, the Immerse platform is currently unable to distribute APK applications directly to an Android device. This means that applications will need to be loaded onto the device manually.

The most basic way to install an application on your Android device is to use adb. More information on how to use adb can be found here. Alternatively, Oculus Quest specific instructions can be found here.

Joining a session

To join an Immerse Session on an android device as as the Oculus Quest, a PIN must first be entered. This can be revealed to the attendee in a number of ways:

1. Via an invitation Email. When invited to a Session, the user will receive an Email containing their unique PIN
2. Via the (Get PIN) button in the Invitations sub-tab
3. By clicking on a session link and revealing the URL; choosing Get PIN when prompted.

🚧

Due to current platform limitations to create a session and get a pin you must have a scene with a Windows or WebGL build uploaded, if the pin options still do not show please message your Immerse contact for access.

Upon launching the respective Oculus Quest application, built with the latest Immerse SDK, the Session participant will be presented with a PINpad, which is used to enter the PIN.

Joining an Immerse Session on an HTC Vive / Oculus Rift

Desktop Immerse VR Sessions are joined via the Google Chrome browser on a Windows PC, with SteamVR enabled.

To join a Session in a headset, the Immerse VR Launcher application must first be installed. This will be used to initiate every VR session. The Immerse Launcher is a small, executable application, installed on a PC running VR hardware. Once installed, it will initialise when an Immerse VR session has been started and manage the downloading of VR content to the headset. The Immerse Launcher will cache VR content, reducing download times.

  1. Download and install the Immerse VR Launcher
    Firstly download and run the Immerse Launcher . During installation, select [Yes] if asked whether the Visual C++ 2015 64-Bit Redistributable can be installed

  2. Join Immerse VR Session
    Access the join URL (in the form vr.immerse.io/s/#########) using the Google Chrome browser.

(An Immerse VR session requires use of the microphone and headphones on the HMD, so these will be checked before each session. )

🚧

If Chrome notifies you that "vr.immerse.io wants to use your microphone and / or camera" you must select β€˜Allow’ or you will not be able to join the session.

After access has been granted, an option to join via [Web] or [VR] will be offered - choose [VR]

The previously installed Immerse Launcher will initialise bringing up this message in Chrome:

Select [Open ImmerseVRLauncher] when prompted.

When the Session is loaded, put on the VR headset.

Voice communication in an Immerse Session (PCVR / web browser)

When using the Google Chrome browser and PCVR headset, user voice data is sent and received via the browser, ensuring a consistent experience across all platforms.

To mute themselves, a VR user must first remove the headset and use the mute button in the browser.

Voice communication in the Oculus Quest is handled directly in the Immerse app.

The Immerse Launcher

The Immerse Launcher is a small, executable application, installed on a PC running VR hardware. Once installed, it will initialise when an Immerse VR session has been started and manage the downloading of VR content to the headset.

The Immerse Launcher will cache VR content, reducing download times.

Updated 19 days ago

Immerse Sessions


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.