SONY

Build your first app

This page describes how to build a simple Spatial Reality Display app. You will learn how to setup an Unreal Engine project and how to show a 3D Cube on the Spatial Reality Display.

  1. You have already Setup Spatial Reality Display and Setup Spatial Reality Display Settings.
  2. The Epic Games Launcher and Unreal Engine are installed.
  1. Launch Unreal Editor you have installed with Spatial Reality Display Plugin and Templates. Unreal Project Browser will automatically opened.

  2. Under New Project Categories, select Games for your project category, then click Next.

  3. Select Spatial Reality Display for your project's template, then click Next.

  4. On the Project Settings page, you can choose Blueprint or C++, performance, target platform and with or without Starter Content. You cannot select Raytracing Enabled.

  5. Choose where you want to store your project and give your project a name. Click Create Project to finish.

  1. Create a new Unreal Engine project by using Unreal Editor you have installed with Spatial Reality Display Plugin.

    1. Create a New Project for Unreal Engine.

    2. On the Project Settings page, you cannot select Raytracing Enabled.

  2. Enable Spatial Reality Display Plugin.

    1. In the Edit menu, open the Plugins.

    2. Select the Installed tab on the left and locate the Spatial Reality Display Plugin.

    3. Check the Enabled check box.

  3. Enabling the Forward Shading Renderer is recommended, which may lead to better performance on Spatial Reality Display.

    1. In the Edit menu, open the Project Settings.

    2. Select the Rendering tab on the left and locate the Forward Shading category.

    3. Enable Forward Shading.

    4. You will be prompted to restart the editor where after the restart, you can begin using the Forward Renderer options and features.

  4. Create a new Level and open it.

  5. Set the level you have created as Editor Startup Map and Game Default Map.

  6. Place SRDisplay Manager Actor and lights anywhere on the level.

  1. Place a Cube Actor inside the Spatial Reality Display View Space(the blue box area shown by SRDisplay Manager).

    The scale of the Spatial Reality Display View Space may be too small for placing a Cube Actor inside it. Adjust the scale of the SRDisplay Manager Actor to fit the Cube within the Spatial Reality Display View Space. For more detail about Spatial Reality Display View Space, see World Scaling.

  1. Select VR Preview from the dropdown menu next to Play button.

Tips

Plugin for Unreal Engine 1.2.0 or later supports playback without Spatial Reality Display. (RunWIthout mode) You can run the project by selecting "Selected Viewport", "New Editor Window" or "Standalone Game" when the Spatial Reality Display is not connected.

Tips

A red message may appear in the upper left part of the screen during a VR Preview or when playing a development build package.You can remove the red message by adding a node to the level blueprint as shown below.
Add an `Execute Console Command` node and specify the `DisableAllScreenMessages` command.

  1. Click on File > Package Project > Windows (64-bit) in the Editor's main menu. Spatial Reality Display Plugin only supports Windows (64-bit).

  2. You will be presented with a dialog for selecting the target directory. If packaging completes successfully, this directory will then contain the packaged project.

  1. Open an existing project using Unreal Editor with the Spatial Reality Display Plugin installed.

    Caution

    Projects with Raytracing enabled are not available.

  2. Enable Spatial Reality Display Plugin.

    1. In the Edit menu, open the Plugins.

    2. Select the Installed tab on the left and locate the Spatial Reality Display Plugin.

    3. Check the Enabled check box.

      Uncheck Enabled check box for other VR Plugins and MR Plugins.

  3. Enabling the Forward Shading Renderer is recommended, which may lead to better performance on Spatial Reality Display.

    1. In the Edit Menu, open the Project Settings.
    2. Select the Rendering tab on the left and locate the Forward Shading category.
    3. Enable Forward Shading.

      You will be prompted to restart the editor where after the restart, you can begin using the Forward Renderer options and features.

  4. Place SRDisplay Manager Actor and lights anywhere on the level.