QMediaRecorder¶

The QMediaRecorder class is used for the recording of media content. More…

Inherited by: QAudioRecorder

Synopsis¶

Functions¶

def actualLocation ()
def audioCodecDescription (codecName)
def audioSettings ()
def availability ()
def availableMetaData ()
def containerDescription (format)
def containerFormat ()
def duration ()
def error ()
def errorString ()
def isAvailable ()
def isMetaDataAvailable ()
def isMetaDataWritable ()
def isMuted ()
def metaData (key)
def outputLocation ()
def setAudioSettings (audioSettings)
def setContainerFormat (container)
def setEncodingSettings (audioSettings[, videoSettings=QVideoEncoderSettings()[, containerMimeType=”“]])
def setMetaData (key, value)
def setOutputLocation (location)
def setVideoSettings (videoSettings)
def state ()
def status ()
def supportedAudioCodecs ()
def supportedContainers ()
def supportedVideoCodecs ()
def videoCodecDescription (codecName)
def videoSettings ()
def volume ()

Slots¶

def pause ()
def record ()
def setMuted (muted)
def setVolume (volume)
def stop ()

Signals¶

def actualLocationChanged (location)
def availabilityChanged (availability)
def availabilityChanged (available)
def durationChanged (duration)
def error (error)
def metaDataAvailableChanged (available)
def metaDataChanged ()
def metaDataChanged (key, value)
def metaDataWritableChanged (writable)
def mutedChanged (muted)
def stateChanged (state)
def statusChanged (status)
def volumeChanged (volume)

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

QAudioRecorder

class QMediaRecorder(mediaObject[, parent=None])¶

param parent

QObject

param mediaObject

QMediaObject

Constructs a media recorder which records the media produced by mediaObject .

The parent is passed to QMediaObject .

PySide2.QtMultimedia.QMediaRecorder.State¶

Constant	Description
QMediaRecorder.StoppedState	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	The recording is requested.
QMediaRecorder.PausedState	The recorder is paused.

PySide2.QtMultimedia.QMediaRecorder.Status¶

Constant	Description
QMediaRecorder.UnavailableStatus	The recorder is not available or not supported by connected media object.
QMediaRecorder.UnloadedStatus	The recorder is avilable but not loaded.
QMediaRecorder.LoadingStatus	The recorder is initializing.
QMediaRecorder.LoadedStatus	The recorder is initialized and ready to record media.
QMediaRecorder.StartingStatus	Recording is requested but not active yet.
QMediaRecorder.RecordingStatus	Recording is active.
QMediaRecorder.PausedStatus	Recording is paused.
QMediaRecorder.FinalizingStatus	Recording is stopped with media being finalized.

PySide2.QtMultimedia.QMediaRecorder.Error¶

Constant	Description
QMediaRecorder.NoError	No Errors.
QMediaRecorder.ResourceError	Device is not ready or not available.
QMediaRecorder.FormatError	Current format is not supported.
QMediaRecorder.OutOfSpaceError	No space left on device.

PySide2.QtMultimedia.QMediaRecorder.actualLocation()¶

Return type: QUrl

PySide2.QtMultimedia.QMediaRecorder.actualLocationChanged(location)¶

Parameters: location – QUrl

PySide2.QtMultimedia.QMediaRecorder.audioCodecDescription(codecName)¶

Parameters: codecName – unicode
Return type: unicode

Returns a description of an audio codec .

PySide2.QtMultimedia.QMediaRecorder.audioSettings()¶

Return type: QAudioEncoderSettings

Returns the audio encoder settings being used.

PySide2.QtMultimedia.QMediaRecorder.availability()¶

Return type: AvailabilityStatus

Returns the availability of this functionality.

See also

availabilityChanged()

PySide2.QtMultimedia.QMediaRecorder.availabilityChanged(availability)¶

Parameters: availability – AvailabilityStatus

PySide2.QtMultimedia.QMediaRecorder.availabilityChanged(available)

Parameters: available – bool

PySide2.QtMultimedia.QMediaRecorder.availableMetaData()¶

Return type: list of strings

Returns a list of keys there is meta-data available for.

PySide2.QtMultimedia.QMediaRecorder.containerDescription(format)¶

Parameters: format – unicode
Return type: unicode

Returns a description of a container format .

PySide2.QtMultimedia.QMediaRecorder.containerFormat()¶

Return type: unicode

Returns the selected container format.

See also

setContainerFormat()

PySide2.QtMultimedia.QMediaRecorder.duration()¶

Return type: qint64

PySide2.QtMultimedia.QMediaRecorder.durationChanged(duration)¶

Parameters: duration – qint64

PySide2.QtMultimedia.QMediaRecorder.error()¶

Return type: Error

Returns the current error state.

See also

errorString()

PySide2.QtMultimedia.QMediaRecorder.error(error)

Parameters: error – Error

PySide2.QtMultimedia.QMediaRecorder.errorString()¶

Return type: unicode

Returns a string describing the current error state.

See also

error()

PySide2.QtMultimedia.QMediaRecorder.isAvailable()¶

Return type: bool

Returns true if media recorder service ready to use.

See also

availabilityChanged()

PySide2.QtMultimedia.QMediaRecorder.isMetaDataAvailable()¶

Return type: bool

PySide2.QtMultimedia.QMediaRecorder.isMetaDataWritable()¶

Return type: bool

PySide2.QtMultimedia.QMediaRecorder.isMuted()¶

Return type: bool

PySide2.QtMultimedia.QMediaRecorder.metaData(key)¶

Parameters: key – unicode
Return type: object

Returns the value associated with a meta-data key .

See also

setMetaData()

PySide2.QtMultimedia.QMediaRecorder.metaDataAvailableChanged(available)¶

Parameters: available – bool

PySide2.QtMultimedia.QMediaRecorder.metaDataChanged()¶

PySide2.QtMultimedia.QMediaRecorder.metaDataChanged(key, value)

Parameters

key – unicode
value – object

PySide2.QtMultimedia.QMediaRecorder.metaDataWritableChanged(writable)¶

Parameters: writable – bool

PySide2.QtMultimedia.QMediaRecorder.mutedChanged(muted)¶

Parameters: muted – bool

PySide2.QtMultimedia.QMediaRecorder.outputLocation()¶

Return type: QUrl

See also

setOutputLocation()

PySide2.QtMultimedia.QMediaRecorder.pause()¶

Pause recording.

The recorder state is changed to PausedState .

Depending on platform recording pause may be not supported, in this case the recorder state stays unchanged.

PySide2.QtMultimedia.QMediaRecorder.record()¶

Start recording.

While the recorder state is changed immediately to RecordingState , recording may start asynchronously, with statusChanged ( RecordingStatus ) signal emitted when recording starts.

If recording fails error() signal is emitted with recorder state being reset back to StoppedState .

PySide2.QtMultimedia.QMediaRecorder.setAudioSettings(audioSettings)¶

Parameters: audioSettings – QAudioEncoderSettings

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.

PySide2.QtMultimedia.QMediaRecorder.setContainerFormat(container)¶

Parameters: container – unicode

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.

PySide2.QtMultimedia.QMediaRecorder.setEncodingSettings(audioSettings[, videoSettings=QVideoEncoderSettings()[, containerMimeType=""]])¶

Parameters

audioSettings – QAudioEncoderSettings
videoSettings – QVideoEncoderSettings
containerMimeType – unicode

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.

PySide2.QtMultimedia.QMediaRecorder.setMetaData(key, value)¶

Parameters

key – unicode
value – object

Sets a value for a meta-data key .

Note

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

metaData()

PySide2.QtMultimedia.QMediaRecorder.setMuted(muted)¶

Parameters: muted – bool

See also

isMuted()

PySide2.QtMultimedia.QMediaRecorder.setOutputLocation(location)¶

Parameters: location – QUrl
Return type: bool

See also

outputLocation()

PySide2.QtMultimedia.QMediaRecorder.setVideoSettings(videoSettings)¶

Parameters: videoSettings – QVideoEncoderSettings

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.

PySide2.QtMultimedia.QMediaRecorder.setVolume(volume)¶

Parameters: volume – qreal

See also

volume()

PySide2.QtMultimedia.QMediaRecorder.state()¶

Return type: State

Returns the current media recorder state.

See also

State

PySide2.QtMultimedia.QMediaRecorder.stateChanged(state)¶

Parameters: state – State

PySide2.QtMultimedia.QMediaRecorder.status()¶

Return type: Status

Returns the current media recorder status.

See also

Status

PySide2.QtMultimedia.QMediaRecorder.statusChanged(status)¶

Parameters: status – Status

PySide2.QtMultimedia.QMediaRecorder.stop()¶

Stop recording.

The recorder state is changed to StoppedState .

PySide2.QtMultimedia.QMediaRecorder.supportedAudioCodecs()¶

Return type: list of strings

Returns a list of supported audio codecs.

PySide2.QtMultimedia.QMediaRecorder.supportedContainers()¶

Return type: list of strings

Returns a list of supported container formats.

PySide2.QtMultimedia.QMediaRecorder.supportedVideoCodecs()¶

Return type: list of strings

Returns a list of supported video codecs.

PySide2.QtMultimedia.QMediaRecorder.videoCodecDescription(codecName)¶

Parameters: codecName – unicode
Return type: unicode

Returns a description of a video codec .

See also

setEncodingSettings()

PySide2.QtMultimedia.QMediaRecorder.videoSettings()¶

Return type: QVideoEncoderSettings

Returns the video encoder settings being used.

PySide2.QtMultimedia.QMediaRecorder.volume()¶

Return type: qreal

See also

setVolume()

PySide2.QtMultimedia.QMediaRecorder.volumeChanged(volume)¶

Parameters: volume – qreal

Qt Documentation

Table of Contents

QMediaRecorder¶

Synopsis¶

Functions¶

Slots¶

Signals¶

Detailed Description¶