Google VR View

This plugin displays previews of 360° images and videos using the Google VR View browser API

For more information on VR View visit https://developers.google.com/vr/concepts/vrview-web

As per the Google specifications, the plugin is supported on the following:-

  • Modern versions of Chrome and Opera on Windows, macOS, Linux, Android, and iOS.
  • Modern versions of Safari on macOS and iOS.
  • Modern versions of Firefox on Windows, macOS, and Linux.
  • Modern versions of IE 11 and Edge on Windows.

If in doubt please visit the site above in your user's browsers and check the test image works to assess suitability

PLEASE NOTE: For correct rendering, images and video should be stored in the equirectangular-panoramic format.

Plugin Configuration

The plugin options page requires the following information to be provided:-

Use Google hosted VR View javascript library? Set to true to use the Google hosted version of the VR View library. It is recommended to host your own local version of the API by following the instructions at https://github.com/googlevr/vrview. Without doing so you will need to make sure your site is publicly available since the Google API needs to access the resource file on your server to be able to render the 3D view. A copy of the library can also be downloaded here.
URL to VR View javascript library (only required if above is false). Please enter the full URL path to the vrview.js library. If this is local to server use relative path e.g. /vrview/build/vrview.js
Resource types to display using VR View This lets you select which resource types will be rendered using VR View
Enable Autopan Choose whether images should automatically start panning on load
Disable VR mode button Set to true to disable the VR mode button
Use original resource file as source for image preview? If false the preview image will be used
Use original resource file as source for video preview? If false the preview video will be used

VR View condition

Field used to determine whether VR View is used This lets you select a metadata field so that the value stored will be used to determine whether or not to display the preview in VR View
Required value for VR View to be enabled This is the value that must be detected in the field above for VR View to be utilised

Additional options

Field used to determine whether image/video is stereo (optional, defaults to false if unset) Value to check for. If found stereo will be set to true
Field used to determine whether roll/pitch should be prevented (optional, defaults to false if unset) Value to check for. If found the is_yaw_only option will be set to true