HomeGuides
HomeGuidesLearn about the Immerse SDK installerLog In

Immerse Scenes

Immerse Scenes are Unity Scenes which have integrated the Immerse SDK, been built, compressed and uploaded to the Immerse Platform. Typically they are Zipped files containing a Windows executable, WebGL content and/or Android APK.

Once uploaded to the Immerse Platform, Immerse Scenes can be managed, shared and added to Immerse Session, allowing them to be accessed by PCVR and browser participants. Uploading an APK allows a 6-digit PIN to be generated which is then input into a standalone VR headset to join a Session.

26282628

All scenes available are listed in the Scenes tab. This includes My Scenes, which are scenes that have been uploaded personally by you and Shared Scenes which have been uploaded by other users in your organisation and shared.

📘

Try out the Immerse Demo Scene!

Look in vr.immerse.io/scenes for "SDK Demo Scene". Add this to an Immerse Session and invite other participants.

Uploading a Scene

  1. Log into the Immerse Platform and go to the Scenes tab at vr.immerse.io/scenes .

  2. Click the [Upload scene] button. The Upload Scene window will appear.

  3. Enter a scene name. The Immerse Platform supports PCVR, Web (browser) and Android scenes.

  4. Upload file(s) (VR files must be .zip format, Web files can be .zip or .tar.gz.)

Note: The file size limit is 500 MB for Web and 1 GB for VR files.

12611261
  1. Upload Thumbnail (recommended). Choose an image to represent the scene in the scene list. (.png or .jpg format supported).

  2. Share scene (optional). If checked, any person in your organisation will be able to add this scene to a space.

  3. Add custom messages (optional - see below)

12611261
  1. [Save] Scene

Trusted by DHL, GE, QinetiQ, ShellTrusted by DHL, GE, QinetiQ, Shell

The eye symbol signifies that the scene has been shared inside the user's organisation. The mail icon shows how many Custom Messages the scene contains.

Editing a Scene

After an Immerse Scene has been created, its VR and WebGL files can be updated by clicking on the scene's thumbnail and uploading new versions.

Custom Messages (advanced)

Custom Messages provide a way for objects, data and state to be synchronised across multiple users and persisted in an Immerse Session.

📘

Before deploying an application to the Immerse Platform, contact its developer to determine whether Custom Messages have been used in its creation.

Custom Messages are defined directly in the Immerse SDK and are also configured when an Immerse Scene is uploaded to the Immerse Platform.

898898

Custom Messages defined in the Unity Editor, in the Immerse SDK

After uploading a zipped PCVR, WebGL or Android file (which has been built and compressed using the Immerse SDK in Unity and compressed, along with a "metadata.json" file) Custom Messages will be automatically configured for the corresponding Immerse Scene:

706706

Uploading a WebGL application built with the Immerse SDK, automatically prefills its two Custom Messages

How to manually configure Custom Messages

❗️

Take extra care when configuring Custom Messages

Any errors or typos could make the experience unstable, or even crash

Custom Messages are automatically configured when PCVR, WebGL or an Android file is uploaded, however it is possible to manually configure them too.

The example below defines an example 'XR Socket Service' message:

Name

Type

Destination

Profile

Broadcast back to self?

Persist in session?

XR Socket Service

2900

Scene only

Participant

No

Yes

Click Configure to edit the Scene's Custom Messages, as shown here:

709709

Custom Messages configured in an Immerse Scene

Once in the Scene Message Configuration window, Messages can be added, deleted and modified. When all messages have been added correctly, hit [BACK], then [SAVE]


Related pages