Page Info
Skill Level:
Engine Version:

Samsung Gear VR Headset Prerequisites

Choose your OS:
Prerequisite Topics

This page assumes you have prior knowledge of the following topics. Please read them before proceeding.


Developing for the Gear VR Headset requires Unreal Engine 4.7.4 or later. Also, Codeworks for Android 1R6 supports Android-24, however, you will still need to use Android-19 or Android-21 when targeting the GearVR.

With the 4.7 release of Unreal Engine 4 (UE4), you can now build Virtual Reality (VR) projects for the Samsung Gear VR Headset that can transform your supported Samsung Galaxy Smartphone into an immersive VR device. In the following sections, we will go over everything you need to know to get your Samsung Galaxy Smartphone properly setup so that it can work with the Samsung Gear VR headset.

Gear VR Official Documentation

For a more in-depth look at how the Gear VR SDK works or for more information on Oculus Mobile VR development check out the official Oculus documents linked below.

Gear VR Headset Prerequisites

Before we can get into UE4 Gear VR development, we first must make sure that the following prerequisites are fulfilled because if we don't, we run the risk of having Gear VR projects not working with the Gear VR Headset.

  • Make sure you have the USB cord used for charging your Samsung Galaxy Smartphone available and plugged into a USB port on the PC you are developing on. The USB cord is of vital importance, as this is how you transfer data between your development PC and your Smartphone.

  • Only certain types of Samsung Galaxy Smartphones will work with the Gear VR Headset. The Oculus website has a list of phone models that will work with the Gear VR Headset. Make sure to double check that the Samsung Galaxy Smartphone you are buying is the correct model that will work with the Gear VR Headset.

  • Make sure to download and install the specific USB drivers for your Galaxy Smartphone from the Samsung Website .

  • Download Unreal Engine version 4.16 or later from the UE4 Launcher or Github .

  • Install the CodeWorks for Android 1R6, which can be found in Engine\Extras\Android.

  • Check to see if Developer Mode has been enabled on your Samsung Galaxy Smartphone and if not, enable it.

  • Also, make sure to check that USB Debugging has been enabled to ensure that you can load data onto the Smartphone from your PC.


  • With your Smartphone plugged into your development PC via USB, make sure to accept the RSA Fingerprint key from your PC. This way, your development PC and Smartphone can send data back and forth. Also, make sure to check Always allow this computer to ensure that your development PC can always interact with this Smartphone when plugged in.


  • Generate and download the OSIG File for your Samsung Smartphone using your Smartphone's Device ID and the Oculus website. If you are not sure how to get your Smartphone's Device ID, the Oculus website has detailed directions on how to do this.


  • After you download the OSIG file, create a folder called assets and place the OSIG file inside of it. Then, place that folder in Engine/Build/Android/Java.

    If you do not do this, your project will not be able to run on your Galaxy Smartphone.


  • You can also place the OSIG file in your project's Build/Android/assets directory instead of Engine/Build/Android/Java. Keep in mind that adding your OSIG file in this manner will result in your OSIG file only being used in the project that it is added to and not for any Gear VR project.

It is very important that you make sure all items listed in the Gear VR Prerequisites section are completed before moving on to the next section. Skipping a step could result in your project not working with the Gear VR Headset.