Qt 5.7 | Qt Multimedia | C++ Classes | QAudioEncoderSettings

Qt 5.7.1 Reference Documentation

# QAudioEncoderSettings Class

The QAudioEncoderSettings class provides a set of audio encoder settings. More...

Header: | #include <QAudioEncoderSettings>
qmake: | QT += multimedia

- List of all members, including inherited members

## Public Functions

| QAudioEncoderSettings()
| QAudioEncoderSettings(const QAudioEncoderSettings &other)
| ~QAudioEncoderSettings()
int | bitRate() const
int | channelCount() const
QString | codec() const
QMultimedia::EncodingMode | encodingMode() const
QVariant | encodingOption(const QString &option) const
QVariantMap | encodingOptions() const
bool | isNull() const
QMultimedia::EncodingQuality | quality() const
int | sampleRate() const
void | setBitRate(int rate)
void | setChannelCount(int channels)
void | setCodec(const QString &codec)
void | setEncodingMode(QMultimedia::EncodingMode mode)
void | setEncodingOption(const QString &option, const QVariant &value)
void | setEncodingOptions(const QVariantMap &options)
void | setQuality(QMultimedia::EncodingQuality quality)
void | setSampleRate(int rate)
bool | operator!=(const QAudioEncoderSettings &other) const
QAudioEncoderSettings & | operator=(const QAudioEncoderSettings &other)
bool | operator==(const QAudioEncoderSettings &other) const

## Detailed Description

The QAudioEncoderSettings class provides a set of audio encoder settings.

A audio encoder settings object is used to specify the audio encoder settings used by QMediaRecorder. Audio encoder settings are selected by constructing a QAudioEncoderSettings object, setting the desired properties and then passing it to a QMediaRecorder instance using the QMediaRecorder::setEncodingSettings() function.

      QAudioEncoderSettings audioSettings;
      audioSettings.setCodec("audio/mpeg");
      audioSettings.setChannelCount(2);

      recorder->setAudioSettings(audioSettings);

See also QMediaRecorder and QAudioEncoderSettingsControl.

## Member Function Documentation

### QAudioEncoderSettings::QAudioEncoderSettings()

Construct a null audio encoder settings object.

### QAudioEncoderSettings::QAudioEncoderSettings(const QAudioEncoderSettings &other)

Constructs a copy of the audio encoder settings object other.

### QAudioEncoderSettings::~QAudioEncoderSettings()

Destroys an audio encoder settings object.

### int QAudioEncoderSettings::bitRate() const

Returns the bit rate of the compressed audio stream in bits per second.

See also setBitRate().

### int QAudioEncoderSettings::channelCount() const

Returns the number of audio channels.

See also setChannelCount().

### QString QAudioEncoderSettings::codec() const

Returns the audio codec.

See also setCodec().

### QMultimedia::EncodingMode QAudioEncoderSettings::encodingMode() const

Returns the audio encoding mode.

See also setEncodingMode() and QMultimedia::EncodingMode.

### QVariant QAudioEncoderSettings::encodingOption(const QString &option) const

Returns the value of encoding option.

See also setEncodingOption() and encodingOptions().

### QVariantMap QAudioEncoderSettings::encodingOptions() const

Returns the all the encoding options as QVariantMap.

See also encodingOption() and setEncodingOptions().

### bool QAudioEncoderSettings::isNull() const

Identifies if an audio settings object is initialized.

Returns true if the settings object is null, and false if it is not.

### QMultimedia::EncodingQuality QAudioEncoderSettings::quality() const

Returns the audio encoding quality.

See also setQuality().

### int QAudioEncoderSettings::sampleRate() const

Returns the audio sample rate in Hz.

See also setSampleRate().

### void QAudioEncoderSettings::setBitRate(int rate)

Sets the audio bit rate in bits per second.

See also bitRate().

### void QAudioEncoderSettings::setChannelCount(int channels)

Sets the number of audio channels.

A value of -1 indicates the encoder should make an optimal choice based on what is available from the audio source and the limitations of the codec.

See also channelCount().

### void QAudioEncoderSettings::setCodec(const QString &codec)

Sets the audio codec.

See also codec().

### void QAudioEncoderSettings::setEncodingMode(QMultimedia::EncodingMode mode)

Sets the audio encoding mode setting.

If QMultimedia::ConstantQualityEncoding is set, the quality encoding parameter is used and bit rate is ignored, otherwise the bitrate is used.

The audio codec, channels count and sample rate settings are used in all the encoding modes.

See also encodingMode() and QMultimedia::EncodingMode.

### void QAudioEncoderSettings::setEncodingOption(const QString &option, const QVariant &value)

Set the encoding option to value.

The supported set and meaning of encoding options are system and selected codec specific.

See also encodingOption() and setEncodingOptions().

### void QAudioEncoderSettings::setEncodingOptions(const QVariantMap &options)

Replace all the encoding options with options.

The supported set and meaning of encoding options are system and selected codec specific.

See also encodingOptions(), encodingOption(), and setEncodingOption().

### void QAudioEncoderSettings::setQuality(QMultimedia::EncodingQuality quality)

Set the audio encoding quality.

Setting the audio quality parameter allows backend to choose the balanced set of encoding parameters to achieve the desired quality level.

The quality settings parameter is only used in the constant quality encoding mode.

See also quality().

### void QAudioEncoderSettings::setSampleRate(int rate)

Sets the audio sample rate in Hz.

A value of -1 indicates the encoder should make an optimal choice based on what is avaialbe from the audio source and the limitations of the codec.

See also sampleRate().

### bool QAudioEncoderSettings::operator!=(const QAudioEncoderSettings &other) const

Determines if other is of equal value to an audio encoder settings object.

Returns true if the settings objects are not of equal value, and true if they are of equal value.

### QAudioEncoderSettings &QAudioEncoderSettings::operator=(const QAudioEncoderSettings &other)

Assigns the value of other to an audio encoder settings object.

### bool QAudioEncoderSettings::operator==(const QAudioEncoderSettings &other) const

Determines if other is of equal value to an audio encoder settings object.

Returns true if the settings objects are of equal value, and false if they are not of equal value.