2. Gear VR Project Setup

How to set up your project to be used with the Gear VR Headset.

On this page

In the following part of the Gear VR Quick Start, we will go over setting up an Unreal Engine 4 project so that it can be used with the Gear VR HMD.


  1. Once the Editor has loaded, go to the Main Toolbar and select Edit > Plugins to open up the Plugin Menu. From the Plugin Menu, choose the Virtuality Reality section and make sure that the OculusVR Plugin is enabled.

    Click for full image.

    In previous versions of the Engine, Gear VR had its own Plugin that needed to be enabled. If you are not able to use Gear VR with the version of Unreal Engine 4 that you are using, make sure to check the VR Plugins section and enable the Gear VR plugin if it is available.

  2. For any Unreal Engine project to run when it is deployed to a device, you will need to have at least one Level saved. To keep the current Level, go to the Toolbar and press the Save icon to save it, naming it GearVRQSMap.

    Click for full image.

  3. Next, from the Main Menu, go to Edit > Project Settings. Under Project in the Maps & Modes section, find Default Maps and set it to the Level that was just saved in the Editor Start Up and Game Default Map.

    Click for full image.

  4. Now, go to Engine > Input. In the Mobile section, set the Default Touch Interface to None by clicking on the Default Touch Interface input box and selecting None from the drop down.

    Click for full image.

  5. In Platforms, under Android, go to the ApkPackaging section and press the Configure Now button then set the following settings:

    Click for full image.

    • Minimum SDK Version: 19

    • Target SDK Version: 19

    • Enable FullScreen Immersive on KitKat and above devices: True

  6. Next, go to the Advanced APKPackaging section and enable the, Configure the AndroidManifest for deployment to Gear VR check mark box.

    Click for full image.

  7. Now, click on the Android SDK section and make sure that Android SDK tools that are needed to build your project point to the correct folder on your PC and set to the following API levels:

    Click for full image.

End Result

When completed, you will have an Unreal Engine 4 project that is ready to be deployed and viewed with your Gear VR HMD.

Select Skin
Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback