How do I get started with Hololight Stream SDK for Unreal?

This article guides you through the complete process of setting up a project in Unreal Engine, installing Hololight Stream, configuring the demo scene, and establishing your first connection - including interactive functionality.

Before integrating the Hololight Stream SDK into your project, review the system, software, and network recommendations and requirements.

Install Unreal Engine

You can download and install Unreal Engine by using the Epic Games launcher. The Epic Games Launcher functions as a central location for your Unreal Engine versions and projects. For this Guide we will work with Unreal Engine 5.5.

1. Download the Epic Games Launcher and run the installation wizard.
2. Start the Epic Games Launcher.
3. Sign in or create an Epic Account.
4. After a successful Login, select Unreal Engine in the left sidebar.
5. Select Library in the top bar.
6. Select the yellow + button next to Engine Versions.
7. Select the version number and select 5.5.4.
8. Select Install and accept the End User Agreement.
9. Choose the install location (default is C:\Program Files).
10. Once installed, select Launch.

Create a project

1. Launch the Unreal Engine 5.5.4.
2. In the Unreal Project Browser select Games, name your project and select Create.
   
3. After the project opens, close it and continue with the next steps.

Download and setup the Hololight Stream SDK

1. Download the Hololight Stream SDK Trial for Unreal Engine 5.5.
2. Open File Explorer in Windows.
3. Navigate to the downloaded .zip, right-click it, and select Extract All.
   
4. After extracting, open the new folder.
5. Copy the entire folder called HololightStream.
   
6. Navigate to your Unreal Projects Folder (default: C:\Users\Documents).
7. Double-click your project folder.
8. Create a folder named Plugins, if there isn't one already.
   
9. Open the newly created folder.
10. Paste the HololightStream folder you copied earlier here.
    

Activate Hololight Stream in your Unreal project

1. Open your project within the Epic Games Launcher.
2. Navigate in the top left corner to Edit > Plugins.
   
3. Search for Hololight Stream.
4. Check the box to activate Hololight Stream (if not already checked).
   
5. When prompted, restart the project.

Open the Hololight Stream Unreal demo scene

1. Select Content Drawer in the bottom left corner.
2. In the Content Drawer, select the Plugins folder on the left side.
   
3. If the Plugins folder isn't visible:
   1. Select Settings on the top right corner of the Content Drawer.
   2. Check Show Plugin Content.
4. In the Plugins folder navigate to:
   Plugins > Hololight Stream Content > VR Template > Maps
5. Double-click VR Template Map and wait for the map to load.
   

Project settings configuration

1. Select Settings in the top right corner of the Unreal Editor and select Project Settings.
   
2. Under Maps and Modes, ensure Game Instance Class is set to GameInstance.
   
3. Under Enhanced Input add 4 Array elements.
4. Add all Input Mapping Context files to the arrays.
   

Blueprint settings configuration

These settings are enabled by default, but it’s a good idea to double-check. Verifying the configuration ensures a smooth startup and helps prevent common issues.

1. Select the Blueprint Icon in the top left of the editor.
2. Navigate to
   World Override Gamemode > select GameModeBase class > select VRGameMode
   
   

Run your Project for the first time

1. Select the three dots next to the play button at the top.
2. Select VR Preview.