Using WebVR with Microsoft Edge

The Microsoft Edge browser (build 15002+ with Windows 10 Creators Update) now supports immersive 3D Virtual Reality (VR) applications on the web using the WebVR 1.1 JavaScript API. Viewing WebVR content requires a Windows Mixed Reality headset, or the Windows Mixed Reality Portal Simulator (accessible via Developer Mode in the Windows 10 Creators Update).

Note

To check which version of Microsoft Edge you currently have installed, open Microsoft Edge, in the top-right corner of the browser select … to open the menu, then select "Settings", and scroll down to find your version number under the "About this app" heading. Updates to Edge are automatically installed when Windows 10 is updated. To keep Edge up to date, you need to keep Windows 10 up to date. To see which version of Windows 10 your device is currently running, select the Start button, then Settings > System > About. To get Microsoft Edge build 15002+, you must be running Windows 10 Creators Update, go to the Microsoft software download website, and select Update now to install it. The WebVR API surface area is present at all times within Microsoft Edge. However, a call to getVRDisplays() will only return a headset if the operating system has been placed in Developer Mode, and either a headset is plugged in or the simulator has been turned on.

You can do a lot with WebVR on Microsoft Edge.

  • Create 3D virtual objects.
  • Create immersive 3D virtual worlds.
  • Display 360º panoramic images.
  • Engage users with 3D interfaces and game controllers.
  • Play Babylon.js 3D games right in your browser.

*Test it below or see some demos.

Setting up your Mixed Reality headset

If you have a Windows Mixed Reality headset, follow the Immersive headset setup guide to get started. If you do not have a physical device, you can instead use the Windows Mixed Reality simulator to develop and test your WebVR experience.

Since the API is currently a developer feature, you will need to:

  • Ensure you have a 64-bit version of Windows 10
  • Enable Developer mode from Settings > Update & security > For developers
  • Become a Windows Insider
  • Connect your Headset or turn on Simulation

Running WebVR on your Mixed Reality headset

To experience WebVR content on a Windows Mixed Reality headset (using hardware or simulation) you must, with your headset connected:

  • Launch Microsoft Edge either on the desktop, or within Mixed Realty
  • Navigate to a WebVR enabled page
  • Click the Enter VR button within the page (the location and visual representation of this button may vary per website)
  • The first time you try to enter VR on a specific domain, the browser will ask for consent to use immersive view. Click Yes
  • Your headset should begin presenting

*Press the Windows button or escape key to exit the immersive view.

Test WebVR support with your headset

The CodePen embedded below should enable you to test support for your VR headset with the Microsoft Edge. Just click the headset icon below.

Or try viewing this 360-degree photograph from the middle of Greenlake in Seattle, WA.

We used A-Frame, a web framework for building VR experiences, to set up these simple VR tests and embedded them using CodePen.

Play your 3D Babylon.js game in the Microsoft Edge browser by adding WebVR support

If you've created a 3D game with Babylon.js and thought that it might look great in easily-accessible virtual reality (VR) on the web, follow the steps in this tutorial to add WebVR support to your Babylon.js game.