This site has been archived and remains strictly as a historical reference for developers who actively maintain apps built using the legacy Google VR SDK, which was last updated in 2019 and is no longer receiving updates.
  • All developers actively developing experiences for Google Cardboard should use the new open source Cardboard SDKs for iOS, Android NDK, and Unity XR Plugin. These new SDKs offer streamlined APIs, improved device compatibility, and built-in viewer profile QR code scanning.
  • The Daydream View VR headset is no longer available for purchase as of October 15, 2019. Existing apps on supported devices are unaffected for users who previously installed those applications. It is no longer possible to opt-in to Daydream distribution via Google Play.

GvrAudioSurround.SurroundFormat

public static abstract class GvrAudioSurround.SurroundFormat

Defines constants to define surround format.

Constants

int FIRST_ORDER_AMBISONICS Binaurally renders first-order ambisonics.
int FIRST_ORDER_AMBISONICS_WITH_NON_DIEGETIC_STEREO Binaurally renders first-order ambisonics together with a non-diegetic stereo track.
int INVALID Enables the initialization of a yet undefined surround format.
int SECOND_ORDER_AMBISONICS Binaurally renders second-order ambisonics.
int SECOND_ORDER_AMBISONICS_WITH_NON_DIEGETIC_STEREO Binaurally renders second-order ambisonics together with a non-diegetic stereo track.
int SURROUND_FIVE_DOT_ONE Binaurally renders 5.1 surround sound according to the ITU-R BS.775-3 speaker configuration recommendation: -Left (L) at 30 degrees.
int SURROUND_MONO Binaurally renders a virtual mono speaker at 0 degrees (front).
int SURROUND_SEVEN_DOT_ONE Binaurally renders 7.1 surround sound according to the ITU-R BS.775-3 speaker configuration recommendation: - Left (L) at 30 degrees.
int SURROUND_STEREO Binaurally renders virtual stereo speakers at -30 degrees and +30 degrees.
int THIRD_ORDER_AMBISONICS Binaurally renders third-order ambisonics.
int THIRD_ORDER_AMBISONICS_WITH_NON_DIEGETIC_STEREO Binaurally renders third-order ambisonics together with a non-diegetic stereo track.

Public Constructors

Inherited Methods

Constants

public static final int FIRST_ORDER_AMBISONICS

Binaurally renders first-order ambisonics.

Expects 4 channel input in Ambix format (ACN channel ordering / SN3D normalization).

Constant Value: 4

public static final int FIRST_ORDER_AMBISONICS_WITH_NON_DIEGETIC_STEREO

Binaurally renders first-order ambisonics together with a non-diegetic stereo track.

The first 4 channels contain ambisonic AmbiX format. (AmbiX format: 4 channels, ACN channel ordering, SN3D normalization). Channel 5 to 6 contain non-diegetic-stereo.

Constant Value: 7

public static final int INVALID

Enables the initialization of a yet undefined surround format.

Constant Value: 0

public static final int SECOND_ORDER_AMBISONICS

Binaurally renders second-order ambisonics.

Expects 9 channel input in Ambix format (ACN channel ordering / SN3D normalization).

Constant Value: 5

public static final int SECOND_ORDER_AMBISONICS_WITH_NON_DIEGETIC_STEREO

Binaurally renders second-order ambisonics together with a non-diegetic stereo track.

The first 9 channels contain ambisonic AmbiX format. (AmbiX format: 9 channels, ACN channel ordering, SN3D normalization). Channel 10 to 11 contain non-diegetic-stereo.

Constant Value: 8

public static final int SURROUND_FIVE_DOT_ONE

Binaurally renders 5.1 surround sound according to the ITU-R BS.775-3 speaker configuration recommendation: -Left (L) at 30 degrees. - Right (R) at -30 degrees. - Center (C) at 0 degrees. - Low frequency effects (LFE) at front center at 0 degrees. - Left surround (LS) at 110 degrees. - Right surround (RS) at -110 degrees.

The 5.1 channel input layout must match AAC: L, R, C, LFE, LS, RS. Note that this differs from the Vorbis/Opus 5.1 channel layout, which is: L, C, R, LS, RS, LFE.

Constant Value: 3

public static final int SURROUND_MONO

Binaurally renders a virtual mono speaker at 0 degrees (front).

Constant Value: 1

public static final int SURROUND_SEVEN_DOT_ONE

Binaurally renders 7.1 surround sound according to the ITU-R BS.775-3 speaker configuration recommendation: - Left (L) at 30 degrees. - Right (R) at -30 degrees. - Center (C) at 0 degrees. - Low frequency effects (LFE) at front center at 0 degrees. - Left surround 1 (LS1) at 90 degrees. - Right surround 1 (RS1) at -90 degrees. - Left surround 2 (LS2) at 150 degrees. - Right surround 2 (RS2) at -150 degrees.

The 7.1 channel input layout must match AAC: L, R, C, LFE, LS1, RS1, LS2, RS2. Note that this differs from the Vorbis/Opus 7.1 channel layout, which is: L, C, R, LS1, RS1, LS2, RS2, LFE.

Constant Value: 10

public static final int SURROUND_STEREO

Binaurally renders virtual stereo speakers at -30 degrees and +30 degrees.

Constant Value: 2

public static final int THIRD_ORDER_AMBISONICS

Binaurally renders third-order ambisonics.

Expects 16 channel input in Ambix format (ACN channel ordering / SN3D normalization).

Constant Value: 6

public static final int THIRD_ORDER_AMBISONICS_WITH_NON_DIEGETIC_STEREO

Binaurally renders third-order ambisonics together with a non-diegetic stereo track.

The first 16 channels contain ambisonic AmbiX format. (AmbiX format: 16 channels, ACN channel ordering, SN3D normalization). Channel 17 to 18 contain non-diegetic-stereo.

Constant Value: 9

Public Constructors

public GvrAudioSurround.SurroundFormat ()