media3/extensions/gvr/README.md
olly 7ccbc4c436 Remove VR code
- Leaving GvrAudioProcessor for now.
- Removing GvrPlayerActivity because it was never released. Also removing
  related UI classes. These were released, but it's unlikely anyone would
  have been using them directly.

PiperOrigin-RevId: 275822516
2019-10-30 08:47:06 +00:00

1.5 KiB

ExoPlayer GVR extension

DEPRECATED - If you still need this extension, please contact us by filing an issue on our issue tracker.

The GVR extension wraps the Google VR SDK for Android. It provides a GvrAudioProcessor, which uses GvrAudioSurround to provide binaural rendering of surround sound and ambisonic soundfields.

Getting the extension

The easiest way to use the extension is to add it as a gradle dependency:

implementation 'com.google.android.exoplayer:extension-gvr:2.X.X'

where 2.X.X is the version, which must match the version of the ExoPlayer library being used.

Alternatively, you can clone the ExoPlayer repository and depend on the module locally. Instructions for doing this can be found in ExoPlayer's top level README.

Using the extension

  • If using DefaultRenderersFactory, override DefaultRenderersFactory.buildAudioProcessors to return a GvrAudioProcessor.
  • If constructing renderers directly, pass a GvrAudioProcessor to MediaCodecAudioRenderer's constructor.
  • Javadoc: Classes matching com.google.android.exoplayer2.ext.gvr.* belong to this module.