Immerse

Immerse Sessions

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 - 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 panelNew 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 region where the Session will be hosted. By default this will be physically 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 and will be available indefinitely.

πŸ“˜

Single sign-on (SSO) Sessions

For organisations which have single sign-on enabled, Sessions can be made accessible only to users whose accounts were provisioned via SSO.

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 a standalone VR headset (e.g. Oculus Quest)

3 Join Session now

4 Manage invited participants

  • Show, edit, delete and add participants
  • Reassign Session ownership
  • Resend invitations

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 viewDesktop browser view

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 (Oculus Quest) Session

Installing the APK

Due to licensing restrictions, the Immerse Platform is unable to install APK applications directly to an Oculus Quest. This can currently be done in several ways:

  1. Install directly via ADB (specific Oculus Quest instructions )
  2. Deploy via App Lab
  3. Oculus for Business, Oculus-Hosted Apps and Release Channels - for enterprise deployments, this is the recommended process.

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 about a month 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.