Screenshot and Video Capture

Full-resolution, undistorted, single-eye, full-layer-support 2D screenshots and video capture for VR apps are available through the Universal Menu. Video capture is also available by configuring localprefs.

Output File Details

Video Capture writes 1024 resolution, 5 Mb per second mp4 files to the /sdcard/oculus/VideoShots/ directory. Capture files do not currently include audio.

Screenshot writes 1024x1024 jpg files to the /sdcard/Oculus/Screenshots/ directory.

Note: Despite the occurrence of sdcard in this directory path, this is an internal device storage path.

Requirements

  • Android 5.0 or later
  • Target applications must be built against Mobile SDK 1.0.0 or later.

Using the Universal Menu

  1. Launch the application that you would like to take a screenshot of.
  2. Open the Universal Menu and select the Utilities menu as shown with the gaze cursor.
  3. To take a screenshot, select Screenshot. The Universal Menu will close, returning immediately to the running application. The screenshot will execute five seconds after you select the option, giving you a moment to position your view within the scene properly. The countdown is indicated by a blinking red dot in the upper left of your view. The output jpg will be written to the directory indicated above.
  4. To take a video capture, select Capture Video. The Universal Menu will close, returning immediately to the running application. Video recording begins immediately upon returning to the application, and continues until the user returns to the Universal Menu, switches applications, or exits VR mode. The output mp4 will be written to the directory indicated above.

Video Capture using Android System Properties

Note: Screenshot is not available with Android System Properties.

To enable video capture, set the debug.oculus.enableVideoCapture to 1 with the following command:

adb shell setprop debug.oculus.enableVideoCapture 1

When enabled, each enterVrMode will generate a new mp4 file, and every vrapi_EnterVrMode() will create a new video file. For example, if you launch an app from Home, you may find one video file for your Home session, one for the app you launch, one for System Activities if you long-press, and so forth.

To help ensure that there is no disruption to the play experience while recording, you may wish to force the GPU level up and chromatic correction off:

adb shell setprop debug.oculus.enableVideoCapture 1 debug.oculus.gpuLevel 3

The FOV is reduced to 80 degrees, so you are unlikely to see any black pull-in at the edges.

Note: Make sure to disable video capture when you are done, or you will fill your phone up with video of every VR session you run!