Unreal Loading Screens

We strongly recommend adding a loading screen to your Rift or mobile application. Loading screens are required by the Oculus Store.

A simple loading screen presenting the user with a rotating texture can be easily added to your game. You will need to specify a texture for display, either with a provided Blueprint or by modifying the defaultengine.ini configuration file. In both methods, the loading screen is drawn to a VR Compositor Layer, and is guaranteed to render consistently at the required minimum frame rate.

We recommend favoring the configuration file approach over the Blueprint, as Blueprints must be initialized before your Loading Screen can be displayed, and there may be a delay after application launch before they are visible.

In our Unreal source using Oculus SDK 1.14 and earlier, a rotating arrow loading screen was provided by default. Versions using 1.16 and later do not provide a default loading screen.

Create a Loading Screen with a Configuration File

Add an entry similar to the following example to your project’s defaultengine.ini file. The values given in this example work well for a typical icon.

[Oculus.Splash.Settings]
TexturePath=/Game/LoadingIconTexture.LoadingIconTexture
DistanceInMeters=X=6.0 Y=0.0 Z=0.0
SizeInMeters=X=0.25 Y=0.25
RotationDeltaInDegrees=1.0
RotationAxis=X=0.0 Y=0.0 Z=1.0

Create a Loading Screen using a Blueprint

Oculus provides Blueprints to show, hide, and remove loading screens and transition screens. The Add Loading Icon Blueprint requires specifying the path of a texture to be added, and will then display that texture in the middle of the screen during loading.

For greater control over how the icon will be displayed, use the Add Loading Splash Screen Blueprint:

For more information on Oculus Blueprints, see Blueprints.