November 6, 2019 update:
  • There's a new open source Cardboard SDK for iOS and Android NDK that offers a streamlined API, improved device compatibility, and built-in viewer profile QR code scanning. A corresponding Unity package (SDK) is planned for a future release. We recommend that all developers actively building for Google Cardboard migrate (iOS, Android NDK) to the new Cardboard SDK.
October 15, 2019 update:
  • The Daydream View VR headset is no longer available for purchase. However, you can continue to use the existing Google VR SDK to update and distribute your apps to the Google Play Store, and make them available to users in the Daydream app.

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 ()