com.google.cloud.speech.v1beta1

Enum RecognitionConfig.AudioEncoding

java.lang.Object

java.lang.Enum<RecognitionConfig.AudioEncoding>

com.google.cloud.speech.v1beta1.RecognitionConfig.AudioEncoding

All Implemented Interfaces:

Internal.EnumLite, ProtocolMessageEnum, java.io.Serializable, java.lang.Comparable<RecognitionConfig.AudioEncoding>

Enclosing class:

RecognitionConfig

public static enum RecognitionConfig.AudioEncoding
extends java.lang.Enum<RecognitionConfig.AudioEncoding>
implements ProtocolMessageEnum

 Audio encoding of the data sent in the audio message. All encodings support
 only 1 channel (mono) audio. Only `FLAC` includes a header that describes
 the bytes of audio that follow the header. The other encodings are raw
 audio bytes with no header.
 For best results, the audio source should be captured and transmitted using
 a lossless encoding (`FLAC` or `LINEAR16`). Recognition accuracy may be
 reduced if lossy codecs (such as AMR, AMR_WB and MULAW) are used to capture
 or transmit the audio, particularly if background noise is present.
 

Protobuf enum google.cloud.speech.v1beta1.RecognitionConfig.AudioEncoding

Enum Constant Summary

Enum Constants

Enum Constant and Description
AMR Adaptive Multi-Rate Narrowband codec.
AMR_WB Adaptive Multi-Rate Wideband codec.
ENCODING_UNSPECIFIED Not specified.
FLAC This is the recommended encoding for `SyncRecognize` and `StreamingRecognize` because it uses lossless compression; therefore recognition accuracy is not compromised by a lossy codec.
LINEAR16 Uncompressed 16-bit signed little-endian samples (Linear PCM).
MULAW 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
UNRECOGNIZED

Field Summary

Fields

Modifier and Type	Field and Description
static int	AMR_VALUE Adaptive Multi-Rate Narrowband codec.
static int	AMR_WB_VALUE Adaptive Multi-Rate Wideband codec.
static int	ENCODING_UNSPECIFIED_VALUE Not specified.
static int	FLAC_VALUE This is the recommended encoding for `SyncRecognize` and `StreamingRecognize` because it uses lossless compression; therefore recognition accuracy is not compromised by a lossy codec.
static int	LINEAR16_VALUE Uncompressed 16-bit signed little-endian samples (Linear PCM).
static int	MULAW_VALUE 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.

Method Summary

Modifier and Type	Method and Description
static RecognitionConfig.AudioEncoding	forNumber(int value)
static Descriptors.EnumDescriptor	getDescriptor()
Descriptors.EnumDescriptor	getDescriptorForType()
int	getNumber()
Descriptors.EnumValueDescriptor	getValueDescriptor()
static Internal.EnumLiteMap<RecognitionConfig.AudioEncoding>	internalGetValueMap()
static RecognitionConfig.AudioEncoding	valueOf(Descriptors.EnumValueDescriptor desc)
static RecognitionConfig.AudioEncoding	valueOf(int value) Deprecated. Use forNumber(int) instead.
static RecognitionConfig.AudioEncoding	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static RecognitionConfig.AudioEncoding[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ENCODING_UNSPECIFIED

public static final RecognitionConfig.AudioEncoding ENCODING_UNSPECIFIED

 Not specified. Will return result [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT].
 

ENCODING_UNSPECIFIED = 0;

LINEAR16

public static final RecognitionConfig.AudioEncoding LINEAR16

 Uncompressed 16-bit signed little-endian samples (Linear PCM).
 This is the only encoding that may be used by `AsyncRecognize`.
 

LINEAR16 = 1;

FLAC

public static final RecognitionConfig.AudioEncoding FLAC

 This is the recommended encoding for `SyncRecognize` and
 `StreamingRecognize` because it uses lossless compression; therefore
 recognition accuracy is not compromised by a lossy codec.
 The stream FLAC (Free Lossless Audio Codec) encoding is specified at:
 http://flac.sourceforge.net/documentation.html.
 16-bit and 24-bit samples are supported.
 Not all fields in STREAMINFO are supported.
 

FLAC = 2;

MULAW

public static final RecognitionConfig.AudioEncoding MULAW

 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
 

MULAW = 3;

AMR

public static final RecognitionConfig.AudioEncoding AMR

 Adaptive Multi-Rate Narrowband codec. `sample_rate` must be 8000 Hz.
 

AMR = 4;

AMR_WB

public static final RecognitionConfig.AudioEncoding AMR_WB

 Adaptive Multi-Rate Wideband codec. `sample_rate` must be 16000 Hz.
 

AMR_WB = 5;

UNRECOGNIZED

public static final RecognitionConfig.AudioEncoding UNRECOGNIZED

Field Detail

ENCODING_UNSPECIFIED_VALUE

public static final int ENCODING_UNSPECIFIED_VALUE

 Not specified. Will return result [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT].
 

ENCODING_UNSPECIFIED = 0;

See Also:

Constant Field Values

LINEAR16_VALUE

public static final int LINEAR16_VALUE

 Uncompressed 16-bit signed little-endian samples (Linear PCM).
 This is the only encoding that may be used by `AsyncRecognize`.
 

LINEAR16 = 1;

See Also:

Constant Field Values

FLAC_VALUE

public static final int FLAC_VALUE

 This is the recommended encoding for `SyncRecognize` and
 `StreamingRecognize` because it uses lossless compression; therefore
 recognition accuracy is not compromised by a lossy codec.
 The stream FLAC (Free Lossless Audio Codec) encoding is specified at:
 http://flac.sourceforge.net/documentation.html.
 16-bit and 24-bit samples are supported.
 Not all fields in STREAMINFO are supported.
 

FLAC = 2;

See Also:

Constant Field Values

MULAW_VALUE

public static final int MULAW_VALUE

 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
 

MULAW = 3;

See Also:

Constant Field Values

AMR_VALUE

public static final int AMR_VALUE

 Adaptive Multi-Rate Narrowband codec. `sample_rate` must be 8000 Hz.
 

AMR = 4;

See Also:

Constant Field Values

AMR_WB_VALUE

public static final int AMR_WB_VALUE

 Adaptive Multi-Rate Wideband codec. `sample_rate` must be 16000 Hz.
 

AMR_WB = 5;

See Also:

Constant Field Values

Method Detail

values

public static RecognitionConfig.AudioEncoding[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (RecognitionConfig.AudioEncoding c : RecognitionConfig.AudioEncoding.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static RecognitionConfig.AudioEncoding valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getNumber

public final int getNumber()

Specified by:

getNumber in interface Internal.EnumLite

Specified by:

getNumber in interface ProtocolMessageEnum

valueOf

@Deprecated
public static RecognitionConfig.AudioEncoding valueOf(int value)

Deprecated. Use forNumber(int) instead.

forNumber

public static RecognitionConfig.AudioEncoding forNumber(int value)

internalGetValueMap

public static Internal.EnumLiteMap<RecognitionConfig.AudioEncoding> internalGetValueMap()

getValueDescriptor

public final Descriptors.EnumValueDescriptor getValueDescriptor()

Specified by:

getValueDescriptor in interface ProtocolMessageEnum

getDescriptorForType

public final Descriptors.EnumDescriptor getDescriptorForType()

Specified by:

getDescriptorForType in interface ProtocolMessageEnum

getDescriptor

public static final Descriptors.EnumDescriptor getDescriptor()

valueOf

public static RecognitionConfig.AudioEncoding valueOf(Descriptors.EnumValueDescriptor desc)