GyroscopePlugin

API Documentation

Adds gyroscope controls on mobile devices.

This plugin is available in the core photo-sphere-viewer package in dist/plugins/gyroscope.js.

Usage

Once enabled the plugin will add a new "Gyroscope" button only shown when the gyroscope API is available.

const viewer = new PhotoSphereViewer.Viewer({
  plugins: [
    PhotoSphereViewer.GyroscopePlugin,
  ],
});

WARNING

There are known inconsistencies of orientation data accross devices. If the panorama is not displayed in the expected orientation, this plugin is not faulty.

Configuration

touchmove

• type: boolean
• default: true

Allows to pan horizontally the camera when the gyroscope is enabled (requires global mousemove=true).

absolutePosition

• type: boolean
• default: false

By default the camera will keep its current horizontal position when the gyroscope is enabled. Turn this option true to enable absolute positionning and only use the device orientation.

moveMode

• type: smooth | fast
• default: smooth

How the gyroscope data is used to rotate the panorama.

lang

• type: object
• default:

lang: {
    gyroscope : 'Gyroscope',
}

Note: this option is not part of the plugin but is merged with the main lang object.

Buttons

This plugin adds buttons to the default navbar:

• gyroscope allows to toggle the gyroscope control

If you use a custom navbar you will need to manually add the buttons to the list.