Enum RecognitionConfig.AudioEncoding

  • All Implemented Interfaces:
    com.google.protobuf.Internal.EnumLite, com.google.protobuf.ProtocolMessageEnum, Serializable, Comparable<RecognitionConfig.AudioEncoding>
    Enclosing class:
    RecognitionConfig

    public static enum RecognitionConfig.AudioEncoding
    extends Enum<RecognitionConfig.AudioEncoding>
    implements com.google.protobuf.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 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;
    • 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​(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:
        IllegalArgumentException - if this enum type has no constant with the specified name
        NullPointerException - if the argument is null
      • getNumber

        public final int getNumber()
        Specified by:
        getNumber in interface com.google.protobuf.Internal.EnumLite
        Specified by:
        getNumber in interface com.google.protobuf.ProtocolMessageEnum
      • valueOf

        @Deprecated
        public static RecognitionConfig.AudioEncoding valueOf​(int value)
        Deprecated.
        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:
        value - the name of the enum constant to be returned.
        Returns:
        the enum constant with the specified name
        Throws:
        IllegalArgumentException - if this enum type has no constant with the specified name
        NullPointerException - if the argument is null
      • getValueDescriptor

        public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor()
        Specified by:
        getValueDescriptor in interface com.google.protobuf.ProtocolMessageEnum
      • getDescriptorForType

        public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType()
        Specified by:
        getDescriptorForType in interface com.google.protobuf.ProtocolMessageEnum
      • getDescriptor

        public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor()
      • valueOf

        public static RecognitionConfig.AudioEncoding valueOf​(com.google.protobuf.Descriptors.EnumValueDescriptor desc)
        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:
        desc - the name of the enum constant to be returned.
        Returns:
        the enum constant with the specified name
        Throws:
        IllegalArgumentException - if this enum type has no constant with the specified name
        NullPointerException - if the argument is null