Introduction to Oculus Browser

There are APIs and other technologies to help you create VR experiences for the browser. VR browser content can include immersive 3D scenes built with the WebGL and WebVR APIs and enhanced 2D web experiences running in VR. Everything possible today on a desktop or mobile browser is also possible in a VR browser.

This guide introduces you to the APIs and libraries to get you started developing your own VR browser experiences. We provide an overview of our Oculus Browser to help you understand how to test the experiences you build.

Many other browsers are also starting to support virtual reality experiences; by developing an experience for Oculus Browser your content should work everywhere WebVR is supported.

WebVR and Oculus Browser

WebVR is a browser API used to interface with VR headsets. Working with WebVR directly requires knowledge of JavaScript and WebGL. Though WebVR is an evolving API, a configuration of the API has crystallized and Oculus Browser targets this configuration. All of our samples and documentation explain how to use this version of the API and also where we diverge from it and why. Interfacing with a VR headset using WebVR is typically done in two phases:

  • Setup. The application detects the headset, described by the VRDevice object, and targets it for presentation.
  • Per-Frame Rendering. Once setup is complete, a requestAnimationFrame handler is used to query pose data, render the WebGL scene for each eye, and submit it to the headset.

For more information, see Introduction to the Web VR API.

Topic Guide

Release NotesDetails of releases of Oculus Browser
Get StartedCovers getting started developing for Oculus Browser
Debug ContentContains notes for debugging your content in Oculus Browser
Introduction to the Web VR APICovers the setup and the render loop when developing for Web VR API
Optimize RenderingDescribes how to improve rendering performance.
Multiview WebGL RenderingDescribes how to simultaneously render for VR
Interact with a Controller Basics of interacting with a controller from your web experience.
Browser Navigation in VRDescribes how to track history and provide navigation.
Display 360 PhotosDescribes how to details of displaying 360 photos.
React 360Brief description and links for more on how to use React 360.