QMediaRecorder Class▲
-
Header: QMediaRecorder
-
qmake: QT += multimedia
-
Inherits: QObject and QMediaBindableInterface
-
Inherited By: QAudioRecorder
-
Group: QMediaRecorder is part of multimedia, multimedia_recording
Detailed Description▲
The QMediaRecorder class is a high level media recording class. It's not intended to be used alone but for accessing the media recording functions of other media objects, like QRadioTuner, or QCamera.
recorder = new QMediaRecorder(camera);
QAudioEncoderSettings audioSettings;
audioSettings.setCodec("audio/amr");
audioSettings.setQuality(QMultimedia::HighQuality);
recorder->setAudioSettings(audioSettings);
recorder->setOutputLocation(QUrl::fromLocalFile(fileName));
recorder->record();See Also▲
See also QAudioRecorder
Member Type Documentation▲
enum QMediaRecorder::Error▲
|
Constant |
Value |
Description |
|---|---|---|
|
QMediaRecorder::NoError |
0 |
No Errors. |
|
QMediaRecorder::ResourceError |
1 |
Device is not ready or not available. |
|
QMediaRecorder::FormatError |
2 |
Current format is not supported. |
|
QMediaRecorder::OutOfSpaceError |
3 |
No space left on device. |
enum QMediaRecorder::State▲
|
Constant |
Value |
Description |
|---|---|---|
|
QMediaRecorder::StoppedState |
0 |
The recorder is not active. If this is the state after recording then the actual created recording has finished being written to the final location and is ready on all platforms except on Android. On Android, due to platform limitations, there is no way to be certain that the recording has finished writing to the final location. |
|
QMediaRecorder::RecordingState |
1 |
The recording is requested. |
|
QMediaRecorder::PausedState |
2 |
The recorder is paused. |
enum QMediaRecorder::Status▲
|
Constant |
Value |
Description |
|---|---|---|
|
QMediaRecorder::UnavailableStatus |
0 |
The recorder is not available or not supported by connected media object. |
|
QMediaRecorder::UnloadedStatus |
1 |
The recorder is avilable but not loaded. |
|
QMediaRecorder::LoadingStatus |
2 |
The recorder is initializing. |
|
QMediaRecorder::LoadedStatus |
3 |
The recorder is initialized and ready to record media. |
|
QMediaRecorder::StartingStatus |
4 |
Recording is requested but not active yet. |
|
QMediaRecorder::RecordingStatus |
5 |
Recording is active. |
|
QMediaRecorder::PausedStatus |
6 |
Recording is paused. |
|
QMediaRecorder::FinalizingStatus |
7 |
Recording is stopped with media being finalized. |
Property Documentation▲
[read-only] actualLocation : const QUrl▲
This property holds the actual location of the last media content.
The actual location is usually available after recording starts, and reset when new location is set or new recording starts.
Access functions:
-
actualLocation() const
Notifier signal:
-
void actualLocationChanged(const &location)
[read-only] duration : const qint64▲
This property holds the recorded media duration in milliseconds.
Access functions:
-
duration() const
Notifier signal:
-
void durationChanged( duration)
[read-only] metaDataAvailable : const bool▲
This property holds whether access to a media object's meta-data is available.
If this is true there is meta-data available, otherwise there is no meta-data available.
Access functions:
-
bool isMetaDataAvailable() const
Notifier signal:
-
void metaDataAvailableChanged(bool available)
[read-only] metaDataWritable : const bool▲
This property holds whether a media object's meta-data is writable.
If this is true the meta-data is writable, otherwise the meta-data is read-only.
Access functions:
-
bool isMetaDataWritable() const
Notifier signal:
-
void metaDataWritableChanged(bool writable)
muted : bool▲
This property holds whether a recording audio stream is muted.
Access functions:
-
bool isMuted() const
-
void setMuted(bool muted)
Notifier signal:
-
void mutedChanged(bool muted)
outputLocation : QUrl▲
This property holds the destination location of media content.
Setting the location can fail, for example when the service supports only local file system locations but a network URL was passed. If the service does not support media recording this setting the output location will always fail.
The location can be relative or empty; in this case the recorder uses the system specific place and file naming scheme. After recording has stated, QMediaRecorder::outputLocation() returns the actual output location.
Access functions:
-
outputLocation() const
-
bool setOutputLocation(const &location)
[read-only] state : const QMediaRecorder::State▲
This property holds the current state of the media recorder.
The state property represents the user request and is changed synchronously during record(), pause() or stop() calls. Recorder state may also change asynchronously when recording fails.
Access functions:
-
state() const
Notifier signal:
-
void stateChanged( state)
[read-only] status : const QMediaRecorder::Status▲
This property holds the current status of the media recorder.
The status is changed asynchronously and represents the actual status of media recorder.
Access functions:
-
status() const
Notifier signal:
-
void statusChanged( status)
volume : qreal▲
This property holds the current recording audio volume.
The volume is scaled linearly from 0.0 (silence) to 1.0 (full volume). Values outside this range will be clamped.
The default volume is 1.0.
UI volume controls should usually be scaled nonlinearly. For example, using a logarithmic scale will produce linear changes in perceived loudness, which is what a user would normally expect from a volume control. See QAudio::convertVolume() for more details.
Access functions:
-
volume() const
-
void setVolume( volume)
Notifier signal:
-
void volumeChanged( volume)
Member Function Documentation▲
[explicit] QMediaRecorder::QMediaRecorder(QMediaObject *mediaObject, QObject *parent = nullptr)▲
Constructs a media recorder which records the media produced by mediaObject.
The parent is passed to QMediaObject.
[virtual] QMediaRecorder::~QMediaRecorder()▲
Destroys a media recorder object.
void QMediaRecorder::actualLocationChanged(const QUrl &location)▲
Signals that the actual location of the recorded media has changed. This signal is usually emitted when recording starts.
Notifier signal for property actualLocation.
QString QMediaRecorder::audioCodecDescription(const QString &codec) const▲
Returns a description of an audio codec.
QAudioEncoderSettings QMediaRecorder::audioSettings() const▲
Returns the audio encoder settings being used.
See Also▲
See also setAudioSettings(), setEncodingSettings()
QMultimedia::AvailabilityStatus QMediaRecorder::availability() const▲
void QMediaRecorder::availabilityChanged(bool available)▲
Signals that the media recorder is now available (if available is true), or not.
void QMediaRecorder::availabilityChanged(QMultimedia::AvailabilityStatus availability)▲
Signals that the service availability has changed to availability.
QStringList QMediaRecorder::availableMetaData() const▲
Returns a list of keys there is meta-data available for.
QString QMediaRecorder::containerDescription(const QString &format) const▲
Returns a description of a container format.
QString QMediaRecorder::containerFormat() const▲
void QMediaRecorder::durationChanged(qint64 duration)▲
Signals that the duration of the recorded media has changed.
Notifier signal for property duration.
QMediaRecorder::Error QMediaRecorder::error() const▲
void QMediaRecorder::error(QMediaRecorder::Error error)▲
Signals that an error has occurred.
QString QMediaRecorder::errorString() const▲
bool QMediaRecorder::isAvailable() const▲
[override virtual] QMediaObject *QMediaRecorder::mediaObject() const▲
Reimplements: QMediaBindableInterface::mediaObject() const.
Returns the QMediaObject instance that this QMediaRecorder is bound too, or 0 otherwise.
QVariant QMediaRecorder::metaData(const QString &key) const▲
void QMediaRecorder::metaDataAvailableChanged(bool available)▲
Signals that the available state of a media object's meta-data has changed.
Notifier signal for property metaDataAvailable.
void QMediaRecorder::metaDataChanged()▲
Signals that a media object's meta-data has changed.
If multiple meta-data elements are changed, metaDataChanged(const QString &key, const QVariant &value) signal is emitted for each of them with metaDataChanged() changed emitted once.
void QMediaRecorder::metaDataChanged(const QString &key, const QVariant &value)▲
Signal the changes of one meta-data element value with the given key.
void QMediaRecorder::metaDataWritableChanged(bool writable)▲
Signals that the writable state of a media object's meta-data has changed.
Notifier signal for property metaDataWritable.
void QMediaRecorder::mutedChanged(bool muted)▲
Signals that the muted state has changed. If true the recording is being muted.
Notifier signal for property muted.
void QMediaRecorder::pause()▲
Pause recording.
The recorder state is changed to QMediaRecorder::PausedState.
Depending on platform recording pause may be not supported, in this case the recorder state stays unchanged.
void QMediaRecorder::record()▲
Start recording.
While the recorder state is changed immediately to QMediaRecorder::RecordingState, recording may start asynchronously, with statusChanged(QMediaRecorder::RecordingStatus) signal emitted when recording starts.
If recording fails error() signal is emitted with recorder state being reset back to QMediaRecorder::StoppedState.
void QMediaRecorder::setAudioSettings(const QAudioEncoderSettings &settings)▲
Sets the audio encoder settings.
If some parameters are not specified, or null settings are passed, the encoder will choose default encoding parameters, depending on media source properties.
It's only possible to change settings when the encoder is in the QMediaEncoder::StoppedState state.
See Also▲
See also audioSettings(), videoSettings(), containerFormat()
void QMediaRecorder::setContainerFormat(const QString &container)▲
Sets the media container format.
If the container format is not specified, the encoder will choose format, depending on media source properties and encoding settings selected.
It's only possible to change settings when the encoder is in the QMediaEncoder::StoppedState state.
See Also▲
See also audioSettings(), videoSettings(), containerFormat()
void QMediaRecorder::setEncodingSettings(const QAudioEncoderSettings &audio, const QVideoEncoderSettings &video = QVideoEncoderSettings(), const QString &container = QString())▲
Sets the audio and video encoder settings and container format.
If some parameters are not specified, or null settings are passed, the encoder will choose default encoding parameters, depending on media source properties.
It's only possible to change settings when the encoder is in the QMediaEncoder::StoppedState state.
See Also▲
See also audioSettings(), videoSettings(), containerFormat()
void QMediaRecorder::setMetaData(const QString &key, const QVariant &value)▲
Sets a value for a meta-data key.
To ensure that meta data is set corretly, it should be set before starting the recording. Once the recording is stopped, any meta data set will be attached to the next recording.
See Also▲
See also metaData()
void QMediaRecorder::setVideoSettings(const QVideoEncoderSettings &settings)▲
Sets the video encoder settings.
If some parameters are not specified, or null settings are passed, the encoder will choose default encoding parameters, depending on media source properties.
It's only possible to change settings when the encoder is in the QMediaEncoder::StoppedState state.
See Also▲
See also audioSettings(), videoSettings(), containerFormat()
QMediaRecorder::State QMediaRecorder::state() const▲
Returns the current media recorder state.
Getter function for property state.
See Also▲
See also QMediaRecorder::State
void QMediaRecorder::stateChanged(QMediaRecorder::State state)▲
Signals that a media recorder's state has changed.
Notifier signal for property state.
QMediaRecorder::Status QMediaRecorder::status() const▲
Returns the current media recorder status.
Getter function for property status.
See Also▲
See also QMediaRecorder::Status
void QMediaRecorder::stop()▲
Stop recording.
The recorder state is changed to QMediaRecorder::StoppedState.
QStringList QMediaRecorder::supportedAudioCodecs() const▲
Returns a list of supported audio codecs.
QList<int> QMediaRecorder::supportedAudioSampleRates(const QAudioEncoderSettings &settings = QAudioEncoderSettings(), bool *continuous = nullptr) const▲
Returns a list of supported audio sample rates.
If non null audio settings parameter is passed, the returned list is reduced to sample rates supported with partial settings applied.
This can be used 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.
QStringList QMediaRecorder::supportedContainers() const▲
Returns a list of supported container formats.
QList<qreal> QMediaRecorder::supportedFrameRates(const QVideoEncoderSettings &settings = QVideoEncoderSettings(), bool *continuous = nullptr) const▲
Returns a list of frame rates video can be encoded at.
If non null video settings parameter is passed, the returned list is reduced to frame rates supported with partial settings like video codec or resolution applied.
If the encoder supports arbitrary frame rates within the supported range, *continuous is set to true, otherwise *continuous is set to false.
See Also▲
See also QVideoEncoderSettings::frameRate()
QList<QSize> QMediaRecorder::supportedResolutions(const QVideoEncoderSettings &settings = QVideoEncoderSettings(), bool *continuous = nullptr) const▲
Returns a list of resolutions video can be encoded at.
If non null video settings parameter is passed, the returned list is reduced to resolution supported with partial settings like video codec or framerate applied.
If the encoder supports arbitrary resolutions within the supported range, *continuous is set to true, otherwise *continuous is set to false.
See Also▲
See also QVideoEncoderSettings::resolution()
QStringList QMediaRecorder::supportedVideoCodecs() const▲
Returns a list of supported video codecs.
QString QMediaRecorder::videoCodecDescription(const QString &codec) const▲
QVideoEncoderSettings QMediaRecorder::videoSettings() const▲
Returns the video encoder settings being used.
See Also▲
See also setVideoSettings(), setEncodingSettings()