Being able to debug your project on its target device is critical to tracking downwards performance issues and other possible project breaking errors. In the following department, you will learn what tools are available to aid you in debugging your Gear VR projects and how to utilize them.

Enabling Gear VR Developer Fashion

Having the ability to view your Gear VR Project without having to apply the Gear VR Headset tin can significantly speed up the fourth dimension information technology takes to debug an issue by assuasive you quick and like shooting fish in a barrel admission to things like Unreal's console. In the following sections, nosotros will encompass how yous tin set upwards your Gear VR projects so that they tin can be viewed without the Gear VR Headset.

Before y'all tin can practise this, y'all must brand sure that you take a Gear VR application installed to your telephone that has your device signature associated with it. This can exist a downloaded or compiled application of your choice.

1. First, on your Samsung Galaxy Smartphone go to Settings > Apps> Application Manager > Gear VR Service.

   

   Click for total epitome.

2. Next, tap on Storage and then tap on Manage Storage.

   

   Click for full image.

3. And so, tap on the VR Service Version 6 times.

   

   Click for full image.

4. Y'all should now see a scan process happen and when completed you should see the Developer Style toggle on the screen.

   

   Click for full image.

5. At present, you should be able to launch your Gear VR Projection and have it brandish without having to use the Gear VR Headset.

   Be conscientious when enabling VR Developer mode every bit it can drastically drain your phone'due south bombardment. This is because you are overriding settings to disable the screen when the Gear VR Headset when non in apply.

Disabling Gear VR Developer Mode

If for any reason yous need to disable VR Programmer mode, slide the Developer Mode slider from On to Off and VR Programmer style volition be disabled.

Enabling the UE4 Console

The UE4 Console is a potent tool that allows y'all to look at, and in some cases, affect data that is currently being displayed in UE4. Accessing the UE4 console on Mobile devices requires a slightly different arroyo than what yous might exist used to on PC and is explained beneath.

You lot tin get a full listing of available panel commands by inbound DumpConsoleCommands into the console while on a PC and Unreal will and so list all available panel commands in the console.

1. Commencement, make sure that you have enabled Gear VR Developer mode on your telephone. This way you tin can launch your project and see information technology without having to use the Gear VR Headset which, if used, would preclude you from being able to bear upon your phone's screen.

   

   Click for total epitome.

2. Next, launch your Gear VR project by borer on the project's icon to beginning it. When the project has been started, yous should see something looking similar this on your telephone.

   

   Click for full image.

3. With your Gear VR project now running, tap the telephone's screen with Four (4) fingers at in one case to open upwards the Unreal Engine Console. If done correctly, you lot should see something like this on your telephone's screen.

   

   Click for full image.

4. Now input a console command you wish to use in the input box and so press the Ok push button. For this example, we will use the Stat Memory command to see how much memory the project is using.

   

   Click for full image.

5. One time the Ok button has been pressed, your projection should now exist displaying how much memory is being used (and by what).

   

   Click for full image.

6. When you are done debugging, or if you just wish to clear the screen of debugging information, you can input Stat None to articulate the screen of all of the debug information.

   The best selection for console debugging with the Gear VR Headset is to employ a Bluetooth keyboard. This way, you can use the console without having to remove the phone from the headset.

Viewing Gear VR Debug Logs

Having the ability to view debug logs is of critical importance when developing any 3D project. Debug logs can provide vital data and insight into why your projection is not working and, in some cases, even make suggestions as to what you can do to fix things. In the following section, we will go over what y'all demand to do to get debug logs from your Smartphone.

Check out the official Android documentation for more detailed information on all of the diverse things you can do with Logcat.

1. First, make sure that your Smartphone with the application y'all desire to get debug data from is plugged into your PC via USB.

2. Adjacent, open upward a Windows Control Vanquish by pressing the Windows Fundamental + R and and so entering CMD in the Run dialogue box.

   

3. Press the Enter key to launch the Windows Control Line.

   

   Click for full image.

4. Now, input ADB Devices into the control line window and press Enter to display devices attached to your PC.

   

   Click for full paradigm.

   If no devices are listed in ADB Devices make sure that yous take gone through the Gear VR Prerequisites setup department and and so attempt this pace again.

5. Now clear the log cache to ensure that we are getting current debug data by entering the post-obit command.

                 adb logcat -c            

   

   Click for full image.

6. With the log now cleared of old information, launch the application on your Smartphone and enter the following command to get the log data.

                 adb logcat -s UE4 OVR VrApi VrLib VRSVC HmdInfo >logoutput.txt            

   

   Click for full image.

   To see the alive output of the log, omit the >logoutput.txt role and all log updates will happen in the control line window.

7. To complete the log capture, printing CTRL + C on the keyboard and when completed, yous should now have a log file named, logoutput.txt, that is saved to your Users folder in Windows.

   

   Click for full prototype.

   Data will continue to be output to the log file while the command line window is open and running the ADB logcat command. To stop this, all you have to do is press CTRL + C and information will cease being written to the log file.

8. The information that is contained within the log file was generated from adding UE4, OVR, VrApi, VrLib,VRSVC, and HmdInfo to the logcat command. When you look at the log file that was created and search for any of those terms, yous will find all debug information related to those terms.
   Y'all can see an example of this in the image beneath, some of the terms used (OVR, UE4, Vrapi, and VrApi) evidence up in the log with information that is related to those terms.

   

   Click for full image.

If your Gear VR Project is not starting up for some reason, using the logcat command is an excellent way to run across exactly where your project is declining and why. It also provides you with detailed information well-nigh the problem that can then be posted to the UE4 Forums or Respond Hub so that you can become help with the issue.

Wireless Deploying & Debugging

Getting debug information or deploying to your Smartphone while it is in the Gear VR Headset is incommunicable due to the just USB port being used past the Gear VR Headset. However, you tin can work around this outcome by using your Smartphone's Wi-Fi connexion to send debug data to your evolution PC. You tin can even deploy projects in this way; still, it is extremely slow when compared to using the USB cable. In the following section, we will cover all y'all need to know nearly setting upwardly your Smartphone and then that it can transport debug information and be deployed over Wi-Fi.

Please note that for this to work, you have to have your development PC and Galaxy Note 4 on the aforementioned network.

1. Next, open a Windows Control Crush by first pressing the Windows Cardinal + R and then entering CMD in the Run dialogue box that is opened. And then press either the Enter primal on your keyboard or but click on the OK button with your mouse.

   

2. Once the OK push has been toggled, a Windows Command Line window like the following should now be displayed.

   

   Click for full image.

3. Now, enter the following control to run into what your Smartphone'southward IP address is and make certain to take note of it. The IP address yous desire to use is the one that comes later on inet.

                 adb beat out ip -f inet addr evidence wlan0            

   

   Click for full paradigm.

4. Adjacent, enter the following command to change the network connection to TCP and set the port that it should be listening to.

                 adb tcpip 5555            

   

   Click for total prototype.

5. Once the port has been set, it is at present fourth dimension to connect to the Smartphone by entering the following control and pressing the Enter key.

                 adb connect 000.000.000.000 - Supercede with your devices IP Address.            

6. You should now see a message that says continued to with the IP address of your device.

   

   Click for total image.

7. To make sure y'all are connected to Wi-Fi, enter adb devices into the command line window and press the Enter fundamental, and you lot will now meet that in the List of devices attached the IP Address used above is now the only attached device.

   

   Click for total prototype.

With your Smartphone and PC now connected to one another via the network, you can now brainstorm to become debug information from your Smartphone or even deploy projects to your phone without having to apply the USB cable. Nonetheless, keep in mind that deploying to your Smartphone from your PC over the network is slower than using the USB cable.

Return to Wired Deploying & Debugging

To return to using the USB cable for debugging and deployment, input the following command into the command window.

                      ADB USB        

Click for full paradigm.