QMediaRecorder Class

QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&input);
QMediaRecorder recorder;
session.setRecorder(&recorder);
recorder.setQuality(QMediaRecorder::HighQuality);
recorder.setOutputLocation(QUrl::fromLocalFile("test.mp3"));
recorder.record();

Documentación de funciones miembro

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

Construye un grabador multimedia. La grabadora multimedia es hija de parent.

[override virtual noexcept] QMediaRecorder::~QMediaRecorder()

Destruye un objeto grabador multimedia.

[signal] void QMediaRecorder::actualLocationChanged(const QUrl &location)

Señala que la dirección location real del soporte grabado ha cambiado. Esta señal se emite normalmente cuando se inicia la grabación.

void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)

Añade metaData al soporte grabado.

int QMediaRecorder::audioBitRate() const

Devuelve la tasa de bits del flujo de audio comprimido en bits por segundo.

Véase también setAudioBitRate().

[signal] void QMediaRecorder::audioBitRateChanged()

Señala cuando cambia la tasa de bits de audio de la grabación.

int QMediaRecorder::audioChannelCount() const

Devuelve el número de canales de audio.

Véase también setAudioChannelCount().

[signal] void QMediaRecorder::audioChannelCountChanged()

Señala cuando cambia el recuento de canales de audio de grabación.

int QMediaRecorder::audioSampleRate() const

Devuelve la frecuencia de muestreo de audio en Hz.

Véase también setAudioSampleRate().

[signal] void QMediaRecorder::audioSampleRateChanged()

Señala cuando cambia la frecuencia de muestreo del audio de grabación.

QMediaCaptureSession *QMediaRecorder::captureSession() const

Devuelve la sesión de captura de medios.

[signal] void QMediaRecorder::durationChanged(qint64 duration)

Señala que el duration del soporte grabado ha cambiado.

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

Devuelve el modo de codificación.

Véase también setEncodingMode() y EncodingMode.

[signal] void QMediaRecorder::encodingModeChanged()

Señala cuando cambia el modo de codificación.

[signal] void QMediaRecorder::errorOccurred(QMediaRecorder::Error error, const QString &errorString)

Señala que se ha producido un error, con errorString que contiene una descripción del error.

bool QMediaRecorder::isAvailable() const

Devuelve true si el servicio de grabadora multimedia está listo para su uso.

[signal] void QMediaRecorder::metaDataChanged()

Señala que los metadatos de un objeto multimedia han cambiado.

Si se modifican varios elementos de metadatos, metaDataChanged() se emite una vez.

QIODevice *QMediaRecorder::outputDevice() const

Devuelve el dispositivo IO de salida para el contenido multimedia.

Véase también setOutputDevice().

[slot] void QMediaRecorder::pause()

Pone en pausa la grabación.

El estado de la grabadora cambia a QMediaRecorder::PausedState.

Dependiendo de la plataforma, puede que no sea posible pausar la grabación. En este caso, el estado de la grabadora no cambia.

[signal] void QMediaRecorder::qualityChanged()

Señala cuando cambia la calidad de grabación.

[slot] void QMediaRecorder::record()

Inicia la grabación.

Aunque el estado de la grabadora cambia inmediatamente a c{QMediaRecorder::RecordingState}, la grabación puede comenzar de forma asíncrona.

Si la grabación falla, se emite la señal error() y el estado de la grabadora se restablece a QMediaRecorder::StoppedState.

Este método actualiza actualLocation según sus reglas de generación.

QMediaRecorder::RecorderState QMediaRecorder::recorderState() const

Devuelve el estado actual de la grabadora multimedia.

Véase también QMediaRecorder::RecorderState.

[signal] void QMediaRecorder::recorderStateChanged(QMediaRecorder::RecorderState state)

Señala que la dirección state de una grabadora multimedia ha cambiado.

void QMediaRecorder::setAudioBitRate(int bitRate)

Establece el audio bitRate en bits por segundo.

Véase también audioBitRate().

void QMediaRecorder::setAudioChannelCount(int channels)

Establece el número de audio channels.

Un valor de -1 indica que la grabadora debe hacer una elección óptima basada en lo que está disponible en la fuente de audio y las limitaciones del códec.

Véase también audioChannelCount().

void QMediaRecorder::setAudioSampleRate(int sampleRate)

Establece el audio sampleRate en Hz.

Un valor de -1 indica que la grabadora debe hacer una elección óptima basada en lo que está disponible de la fuente de audio, y las limitaciones del códec.

Véase también audioSampleRate().

void QMediaRecorder::setEncodingMode(QMediaRecorder::EncodingMode mode)

Establece el parámetro de codificación mode.

Si ConstantQualityEncoding está establecido, se utiliza el parámetro de codificación de calidad y se ignoran las tasas de bits; en caso contrario, se utilizan las tasas de bits.

Véase también encodingMode() y EncodingMode.

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

Establece los metadatos en metaData.

Véase también metaData().

void QMediaRecorder::setOutputDevice(QIODevice *device)

Establezca el dispositivo IO de salida para el contenido multimedia.

El device debe haber sido abierto en los modos WriteOnly o ReadWrite antes de que comience la grabación.

El grabador multimedia no se apropia del device especificado. Si se ha iniciado la grabación, el dispositivo debe mantenerse vivo y abierto hasta que se emita la señal recorderStateChanged(StoppedState).

Este método reinicia actualLocation inmediatamente a menos que el device especificado sea null.

Si se asigna a la grabadora un dispositivo de salida con capacidad de escritura, se ignora outputLocation y no se genera actualLocation cuando se inicia la grabación. Este comportamiento puede cambiar en el futuro, por lo que recomendamos configurar sólo una salida, ya sea outputLocation o outputDevice.

QMediaRecorder::setOutputDevice sólo es compatible con el backend FFmpeg.

Véase también outputDevice() y outputLocation.

void QMediaRecorder::setVideoBitRate(int bitRate)

Establece el vídeo bitRate en bits por segundo.

Véase también videoBitRate().

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

Establece el vídeo frameRate.

Un valor de 0 indica que la grabadora debe hacer una elección óptima basada en lo que está disponible en la fuente de vídeo y las limitaciones del códec.

Véase también videoFrameRate().

void QMediaRecorder::setVideoResolution(const QSize &size)

Establece la resolución del vídeo codificado en size.

Pase un QSize vacío para que el grabador elija una resolución óptima basada en lo que está disponible en la fuente de vídeo y las limitaciones del códec.

Véase también videoResolution().

void QMediaRecorder::setVideoResolution(int width, int height)

Establece las propiedades width y height de la resolución del vídeo codificado.

[slot] void QMediaRecorder::stop()

La grabadora detendrá la grabación. Sin embargo, el procesamiento de los datos de vídeo y audio pendientes puede tardar todavía algún tiempo. La grabación finaliza cuando el estado de la grabadora cambia a QMediaRecorder::StoppedState.

int QMediaRecorder::videoBitRate() const

Devuelve la tasa de bits del flujo de vídeo comprimido en bits por segundo.

Véase también setVideoBitRate().

[signal] void QMediaRecorder::videoBitRateChanged()

Señala cuando cambia la tasa de bits de vídeo de grabación.

qreal QMediaRecorder::videoFrameRate() const

Devuelve la tasa de fotogramas del vídeo.

Véase también setVideoFrameRate().

[signal] void QMediaRecorder::videoFrameRateChanged()

Señala cuando cambia la velocidad de fotogramas del vídeo grabado.

QSize QMediaRecorder::videoResolution() const

Devuelve la resolución del vídeo codificado.

Véase también setVideoResolution().

[signal] void QMediaRecorder::videoResolutionChanged()

Señala cuando cambia la resolución de la grabación de vídeo.