QAudioEncoderSettingsControl Class

The QAudioEncoderSettingsControl class provides access to the settings of a media service that performs audio encoding. More...

Header: #include <QAudioEncoderSettingsControl>
qmake: QT += multimedia
Inherits: QMediaControl

Public Functions

virtual ~QAudioEncoderSettingsControl()
virtual QAudioEncoderSettings audioSettings() const = 0
virtual QString codecDescription(const QString &codec) const = 0
virtual void setAudioSettings(const QAudioEncoderSettings &settings) = 0
virtual QStringList supportedAudioCodecs() const = 0
virtual QList<int> supportedSampleRates(const QAudioEncoderSettings &settings, bool *continuous = Q_NULLPTR) const = 0
  • 31 public functions inherited from QObject

Protected Functions

QAudioEncoderSettingsControl(QObject *parent = Q_NULLPTR)
  • 9 protected functions inherited from QObject


Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 2 signals inherited from QObject
  • 11 static public members inherited from QObject

Detailed Description

The QAudioEncoderSettingsControl class provides access to the settings of a media service that performs audio encoding.

If a QMediaService supports encoding audio data it will implement QAudioEncoderSettingsControl. This control provides information about the limits of restricted audio encoder options and allows the selection of a set of audio encoder settings as specified in a QAudioEncoderSettings object.

The functionality provided by this control is exposed to application code through the QMediaRecorder class.

The interface name of QAudioEncoderSettingsControl is org.qt-project.qt.audioencodersettingscontrol/5.0 as defined in QAudioEncoderSettingsControl_iid.

See also QMediaService::requestControl() and QMediaRecorder.

Member Function Documentation

[protected] QAudioEncoderSettingsControl::QAudioEncoderSettingsControl(QObject *parent = Q_NULLPTR)

Create a new audio encoder settings control object with the given parent.

[virtual] QAudioEncoderSettingsControl::~QAudioEncoderSettingsControl()

Destroys the audio encoder settings control.

[pure virtual] QAudioEncoderSettings QAudioEncoderSettingsControl::audioSettings() const

Returns the audio encoder settings.

The returned value may be different tha passed to QAudioEncoderSettingsControl::setAudioSettings() if the settings contains the default or undefined parameters. In this case if the undefined parameters are already resolved, they should be returned.

See also setAudioSettings().

[pure virtual] QString QAudioEncoderSettingsControl::codecDescription(const QString &codec) const

Returns description of audio codec.

[pure virtual] void QAudioEncoderSettingsControl::setAudioSettings(const QAudioEncoderSettings &settings)

Sets the selected audio settings.

See also audioSettings().

[pure virtual] QStringList QAudioEncoderSettingsControl::supportedAudioCodecs() const

Returns the list of supported audio codec names.

[pure virtual] QList<int> QAudioEncoderSettingsControl::supportedSampleRates(const QAudioEncoderSettings &settings, bool *continuous = Q_NULLPTR) const

Returns the list of supported audio sample rates, if known.

If non null audio settings parameter is passed, the returned list is reduced to sample rates supported with partial settings applied.

It can be used for example to query the list of sample rates, supported by specific audio codec.

If the encoder supports arbitrary sample rates within the supported rates range, *continuous is set to true, otherwise *continuous is set to false.

Macro Documentation



Defines the interface name of the QAudioEncoderSettingsControl class.

© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.