Refer to the following as guidance on which APIs to use:

New projects:

Existing projects:

Before you begin with Scene, make sure to use the latest version of the Meta Quest or Meta Quest 2 operating system and Oculus Integration SDK. Do the following:

You can use the Scene Actor as any other type of actor in Unreal. The easiest way to start experimenting with the Scene Actor is to place it on a level within the editor. From the “Place Actors” panel, search for the “Oculus Scene Actor” class and drag-drop it anywhere on your level.

Within Scene Capture, you may create two types of entities: Bounded 2D and Bounded 3D entities.

For example, a captured room layout will have its walls, floor, and ceiling represented as Bounded 2D entities. For more details about the various types of scene entities you can capture within Scene Capture, refer to this page.

Within the editor, looking at the details panel for Scene Actors, two maps can be found representing the properties of Bounded 2D and Bounded 3D entities that you will spawn. The key to each map member corresponds to the semantic label associated with a captured scene entity. The maps can be modified to add or remove (hence ignore) the various spawned scene entities during runtime. These maps dictate the scene entities that will make up the final Scene Model.

By default, the Scene Actor will populate properties for the following scene entities:

You can find more information about these labels and the complete list of supported labels here

The map’s member values provide various settings that dictate how you will spawn a scene entity. For example, you will see three properties if you expand one of the map’s members:

For the time being, it is not possible to make use of Scene within PIE or via the Link Quest feature. Scene logic will only work when running the application within the Quest device.