QAudioRecorder Class

The QAudioRecorder class is used for the recording of audio. More...

Header: #include <QAudioRecorder>
qmake: QT += multimedia
Inherits: QMediaRecorder.

Properties

Public Functions

QAudioRecorder(QObject * parent = 0)
~QAudioRecorder()
QString audioInput() const
QString audioInputDescription(const QString & name) const
QStringList audioInputs() const
QString defaultAudioInput() const

Public Slots

void setAudioInput(const QString & name)

Signals

void audioInputChanged(const QString & name)
void availableAudioInputsChanged()

Additional Inherited Members

Detailed Description

The QAudioRecorder class is used for the recording of audio.

The QAudioRecorder class is a high level media recording class and contains the same functionality as QMediaRecorder.

audioRecorder = new QAudioRecorder;

QAudioEncoderSettings audioSettings;
audioSettings.setCodec("audio/amr");
audioSettings.setQuality(QMultimedia::HighQuality);

audioRecorder->setEncodingSettings(audioSettings);

audioRecorder->setOutputLocation(QUrl::fromLocalFile("test.amr"));
audioRecorder->record();

In addition QAudioRecorder provides functionality for selecting the audio input.

QStringList inputs = audioRecorder->audioInputs();
QString selectedInput = audioRecorder->defaultAudioInput();

foreach (QString input, inputs) {
    QString description = audioRecorder->audioInputDescription(input);
    // show descriptions to user and allow selection
    selectedInput = input;
}

audioRecorder->setAudioInput(selectedInput);

The Audio Recorder example shows how to use this class in more detail.

See also QMediaRecorder and QAudioInputSelectorControl.

Property Documentation

audioInput : QString

This property holds the active audio input name.

Access functions:

QString audioInput() const
void setAudioInput(const QString & name)

Notifier signal:

void audioInputChanged(const QString & name)

Member Function Documentation

QAudioRecorder::​QAudioRecorder(QObject * parent = 0)

Constructs an audio recorder. The parent is passed to QMediaObject.

QAudioRecorder::​~QAudioRecorder()

Destroys an audio recorder object.

QString QAudioRecorder::​audioInputDescription(const QString & name) const

Returns the readable translated description of the audio input device with name.

QStringList QAudioRecorder::​audioInputs() const

Returns a list of available audio inputs

[signal] void QAudioRecorder::​availableAudioInputsChanged()

Signal is emitted when the available audio inputs change.

QString QAudioRecorder::​defaultAudioInput() const

Returns the default audio input name.

© 2015 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.