QMediaRecorder Class
La clase QMediaRecorder se utiliza para codificar y grabar una sesión de captura. Más información...
| Encabezado: | #include <QMediaRecorder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| En QML: | MediaRecorder |
| Heredan de: | QObject |
Tipos públicos
| enum | EncodingMode { ConstantQualityEncoding, ConstantBitRateEncoding, AverageBitRateEncoding, TwoPassEncoding } |
| enum | Error { NoError, ResourceError, FormatError, OutOfSpaceError, LocationNotWritable } |
| enum | Quality { VeryLowQuality, LowQuality, NormalQuality, HighQuality, VeryHighQuality } |
| enum | RecorderState { StoppedState, RecordingState, PausedState } |
Propiedades
|
|
Funciones públicas
| QMediaRecorder(QObject *parent = nullptr) | |
| virtual | ~QMediaRecorder() override |
| QUrl | actualLocation() const |
| void | addMetaData(const QMediaMetaData &metaData) |
| int | audioBitRate() const |
| int | audioChannelCount() const |
| int | audioSampleRate() const |
| bool | autoStop() const |
| QMediaCaptureSession * | captureSession() const |
| qint64 | duration() const |
| QMediaRecorder::EncodingMode | encodingMode() const |
| QMediaRecorder::Error | error() const |
| QString | errorString() const |
| bool | isAvailable() const |
| QMediaFormat | mediaFormat() const |
| QMediaMetaData | metaData() const |
| QIODevice * | outputDevice() const |
| QUrl | outputLocation() const |
| QMediaRecorder::Quality | quality() const |
| QMediaRecorder::RecorderState | recorderState() const |
| void | setAudioBitRate(int bitRate) |
| void | setAudioChannelCount(int channels) |
| void | setAudioSampleRate(int sampleRate) |
| void | setAutoStop(bool autoStop) |
| void | setEncodingMode(QMediaRecorder::EncodingMode mode) |
| void | setMediaFormat(const QMediaFormat &format) |
| void | setMetaData(const QMediaMetaData &metaData) |
| void | setOutputDevice(QIODevice *device) |
| void | setOutputLocation(const QUrl &location) |
| void | setQuality(QMediaRecorder::Quality quality) |
| void | setVideoBitRate(int bitRate) |
| void | setVideoFrameRate(qreal frameRate) |
| void | setVideoResolution(const QSize &size) |
| void | setVideoResolution(int width, int height) |
| int | videoBitRate() const |
| qreal | videoFrameRate() const |
| QSize | videoResolution() const |
Ranuras públicas
Señales
| void | actualLocationChanged(const QUrl &location) |
| void | audioBitRateChanged() |
| void | audioChannelCountChanged() |
| void | audioSampleRateChanged() |
| void | autoStopChanged() |
| void | durationChanged(qint64 duration) |
| void | encodingModeChanged() |
| void | errorChanged() |
| void | errorOccurred(QMediaRecorder::Error error, const QString &errorString) |
| void | mediaFormatChanged() |
| void | metaDataChanged() |
| void | qualityChanged() |
| void | recorderStateChanged(QMediaRecorder::RecorderState state) |
| void | videoBitRateChanged() |
| void | videoFrameRateChanged() |
| void | videoResolutionChanged() |
Descripción detallada
Utiliza la clase QMediaRecorder para codificar y grabar contenidos multimedia generados en QMediaCaptureSession. Puedes generar:
- Audio. Utiliza QAudioInput o QAudioBufferInput.
- Vídeo. Utilice QCamera, QScreenCapture, QWindowCapture, QVideoFrameInput o QGStreamerVideoSource (en Linux integrado con el backend multimedia
gstreamer).
Para grabar contenido multimedia, conecta un generador a la sesión de captura multimedia correspondiente.
El rendimiento de la codificación y la grabación de vídeo está limitado por el hardware, el sistema operativo, los controladores gráficos instalados y el formato de vídeo de entrada. Si QCamera, QScreenCapture o QWindowCapture generan fotogramas de vídeo más rápido de lo que QMediaRecorder puede codificarlos y grabarlos, es posible que la grabadora omita algunos fotogramas. Es probable que esto ocurra si la resolución de los fotogramas de entrada es alta, por ejemplo, 4K, y no se dispone de codificación acelerada por hardware. Si generas el vídeo de entrada a través de QVideoFrameInput, el método QVideoFrameInput::sendVideoFrame no hará nada y devolverá false siempre que se alcance esta limitación y la cola interna de fotogramas esté llena. Utiliza la señal QVideoFrameInput::readyToSendVideoFrame para saber cuándo la grabadora está lista para recibir nuevos fotogramas de nuevo. Si no puedes modificar la velocidad de generación de fotogramas de vídeo y no deseas que se pierdan fotogramas, te recomendamos implementar tu propia cola de fotogramas sobre la base de QVideoFrameInput, teniendo en cuenta las limitaciones de memoria del hardware.
QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&audioInput);
QMediaRecorder recorder;
session.setRecorder(&recorder);
recorder.setQuality(QMediaRecorder::HighQuality);
recorder.setOutputLocation(QUrl::fromLocalFile("test.mp3"));
recorder.record();Documentación sobre los tipos de miembro
enum QMediaRecorder::EncodingMode
Enumera los modos de codificación.
| Constante | Valor | Descripción |
|---|---|---|
QMediaRecorder::ConstantQualityEncoding | 0 | La codificación intentará mantener una calidad constante, ajustando la tasa de bits según sea necesario. |
QMediaRecorder::ConstantBitRateEncoding | 1 | La codificación utilizará una tasa de bits constante y ajustará la calidad en consecuencia. |
QMediaRecorder::AverageBitRateEncoding | 2 | La codificación intentará mantener una configuración de velocidad de bits media, pero utilizará más o menos según sea necesario. |
QMediaRecorder::TwoPassEncoding | 3 | El archivo multimedia se procesará primero para determinar sus características y, a continuación, se procesará por segunda vez asignando más bits a las áreas que lo necesiten. |
enum QMediaRecorder::Error
| Constante | Valor | Descripción |
|---|---|---|
QMediaRecorder::NoError | 0 | Sin errores. |
QMediaRecorder::ResourceError | 1 | El dispositivo no está listo o no está disponible. |
QMediaRecorder::FormatError | 2 | El formato actual no es compatible. |
QMediaRecorder::OutOfSpaceError | 3 | No queda espacio libre en el dispositivo. |
QMediaRecorder::LocationNotWritable | 4 | No se puede escribir en la ubicación de salida. |
enum QMediaRecorder::Quality
Enumera los niveles de codificación de calidad.
| Constante | Valor |
|---|---|
QMediaRecorder::VeryLowQuality | 0 |
QMediaRecorder::LowQuality | 1 |
QMediaRecorder::NormalQuality | 2 |
QMediaRecorder::HighQuality | 3 |
QMediaRecorder::VeryHighQuality | 4 |
enum QMediaRecorder::RecorderState
| Constante | Valor | Descripción |
|---|---|---|
QMediaRecorder::StoppedState | 0 | El registrador no está activo. |
QMediaRecorder::RecordingState | 1 | Se ha solicitado la grabación. |
QMediaRecorder::PausedState | 2 | El grabador está en pausa. |
Documentación de la propiedad
[read-only] actualLocation : QUrl
Esta propiedad contiene la ubicación real del último contenido multimedia.
La ubicación real se restablece cuando se asigna un nuevo ` outputLocation ` o un ` outputDevice ` distinto de nulo. Cuando se invoca ` record()` y ` outputDevice ` es ` null ` o no es escribible, el grabador genera la ubicación real basándose en las siguientes reglas.
- Si
outputLocationestá vacío, es un directorio o un archivo sin extensión, el grabador genera la extensión adecuada en función del formato multimedia seleccionado y de los tipos MIME del sistema. - Si
outputLocationes un directorio, el grabador genera un nuevo nombre de archivo dentro de él. - Si «
outputLocation» está vacío, el grabador genera un nuevo nombre de archivo en el directorio específico del sistema para audio o vídeo. - El grabador genera la ubicación real antes de generar «
recorderStateChanged(RecordingState)».
Funciones de acceso:
| QUrl | actualLocation() const |
Señal de notificación:
| void | actualLocationChanged(const QUrl &location) |
audioBitRate : int
Esta propiedad contiene la velocidad de transmisión del flujo de audio comprimido en bits por segundo.
Funciones de acceso:
| int | audioBitRate() const |
| void | setAudioBitRate(int bitRate) |
Señal de notificación:
| void | audioBitRateChanged() |
audioChannelCount : int
Esta propiedad indica el número de canales de audio.
Funciones de acceso:
| int | audioChannelCount() const |
| void | setAudioChannelCount(int channels) |
Señal de notificación:
| void | audioChannelCountChanged() |
audioSampleRate : int
Esta propiedad contiene la frecuencia de muestreo de audio en Hz.
Funciones de acceso:
| int | audioSampleRate() const |
| void | setAudioSampleRate(int sampleRate) |
Señal de notificación:
| void | audioSampleRateChanged() |
autoStop : bool
Esta propiedad controla si el grabador multimedia se detiene automáticamente cuando todas las entradas multimedia han notificado el final de la transmisión o se han desactivado.
El final de la transmisión se notifica enviando un fotograma multimedia vacío, que se puede enviar explícitamente a través de QVideoFrameInput o QAudioBufferInput.
Las entradas de vídeo, concretamente QCamera, QScreenCapture y QWindowCapture, pueden desactivarse mediante la función setActive.
El valor por defecto es false.
QMediaRecorder::autoStop solo es compatible con el backend de FFmpeg.
Funciones de acceso:
| bool | autoStop() const |
| void | setAutoStop(bool autoStop) |
Señal de notificación:
| void | autoStopChanged() |
Véase también QCamera, QScreenCapture y QWindowCapture.
[read-only] duration : qint64
Esta propiedad contiene la duración de la grabación en milisegundos.
Funciones de acceso:
| qint64 | duration() const |
Señal de notificación:
| void | durationChanged(qint64 duration) |
encodingMode : QMediaRecorder::EncodingMode
Esta propiedad contiene el modo de codificación.
Funciones de acceso:
| QMediaRecorder::EncodingMode | encodingMode() const |
| void | setEncodingMode(QMediaRecorder::EncodingMode mode) |
Señal de notificación:
| void | encodingModeChanged() |
Véase también EncodingMode.
[read-only] error : QMediaRecorder::Error
Devuelve el estado de error actual.
Funciones de acceso:
| QMediaRecorder::Error | error() const |
Señal del notificador:
| void | errorChanged() |
Véase también errorString().
[read-only] errorString : QString
Devuelve una cadena que describe el estado de error actual.
Funciones de acceso:
| QString | errorString() const |
Señal de notificación:
| void | errorChanged() |
Véase también error().
mediaFormat : QMediaFormat
Esta propiedad contiene el valor actual de « QMediaFormat » del grabador.
El valor de esta propiedad puede cambiar al invocar record(). Si esto ocurre, se emitirá la señal mediaFormatChanged(). Esto ocurrirá siempre que las propiedades QMediaFormat::audioCodec o QMediaFormat::fileFormat estén establecidas en «unspecified». Si se conecta una fuente de vídeo (QCamera, QScreenCapture o QVideoFrameInput) a QMediaCaptureSession, también se debe especificar QMediaFormat::videoCodec. Los valores de las propiedades « QMediaFormat::audioCodec » y « QMediaFormat::videoCodec » también pueden cambiar si el backend multimedia no es compatible con el formato de archivo o el códec seleccionado.
El valor de la propiedad QMediaFormat::fileFormat también puede cambiar a un formato de solo audio si se ha solicitado un formato de vídeo, pero QMediaCaptureSession no tiene ninguna fuente de vídeo conectada. Por ejemplo, si QMediaFormat::fileFormat está establecido en QMediaFormat::MPEG4, puede cambiarse a QMediaFormat::Mpeg4Audio.
Las aplicaciones pueden determinar si mediaFormat cambiará antes de que comience la grabación llamando a la función QMediaFormat::isSupported(). Al grabar sin ninguna entrada de vídeo, record() no modificará QMediaFormat si se cumple lo siguiente:
- QMediaFormat::fileFormat se especifica
- QMediaFormat::audioCodec se ha especificado
- QMediaFormat::videoCodec no se ha especificado
- QMediaFormat::isSupported() devuelve
true
Al grabar con entrada de vídeo, mediaFormat no se modificará si se cumple lo siguiente:
- QMediaFormat::fileFormat está especificado
- QMediaFormat::audioCodec está especificado
- QMediaFormat::videoCodec está especificado
- QMediaFormat::isSupported() devuelve
true
Nota: La propiedad « QMediaRecorder » no tiene en cuenta la extensión del nombre de archivo de la propiedad « outputLocation » a la hora de determinar la « QMediaFormat::fileFormat », y no ajustará la extensión de « outputLocation » QUrl para que coincida con el formato de archivo seleccionado si se especifica una extensión. Por lo tanto, las aplicaciones deben asegurarse de establecer la propiedad « QMediaRecorder::mediaFormat::fileFormat » para que coincida con la extensión del archivo, o bien no especificar ninguna extensión. Si no se especifica ninguna extensión, la extensión del archivo « actualLocation » se actualizará para que coincida con el formato de archivo utilizado para la grabación.
Funciones de acceso:
| QMediaFormat | mediaFormat() const |
| void | setMediaFormat(const QMediaFormat &format) |
Señal de notificación:
| void | mediaFormatChanged() |
Véase también QMediaFormat::isSupported() y actualLocation.
metaData : QMediaMetaData
Devuelve los metadatos asociados a la grabación.
Funciones de acceso:
| QMediaMetaData | metaData() const |
| void | setMetaData(const QMediaMetaData &metaData) |
Señal de notificador:
| void | metaDataChanged() |
outputLocation : QUrl
Esta propiedad contiene la ubicación de destino del contenido multimedia.
La configuración de la ubicación puede fallar, por ejemplo, cuando el servicio solo admite ubicaciones del sistema de archivos local, pero se ha pasado una URL de red. Si la operación falla, se emite la señal errorOccurred().
La ubicación de salida se ignora si se ha asignado al grabador un ` outputDevice ` en el que se puede escribir. Este comportamiento puede cambiar en el futuro, por lo que recomendamos establecer una única salida, ya sea ` outputLocation ` o ` outputDevice`.
La ubicación de salida puede estar vacía, ser un directorio o un archivo. La ruta a un directorio o archivo puede ser relativa o absoluta. El método record() genera la ubicación real según la ubicación de salida especificada y la configuración específica del sistema. Consulte la descripción de la propiedad actualLocation para obtener más detalles.
Funciones de Access:
| QUrl | outputLocation() const |
| void | setOutputLocation(const QUrl &location) |
Véase también actualLocation y outputDevice().
quality : Quality
Devuelve la calidad de la grabación.
Funciones de acceso:
| QMediaRecorder::Quality | quality() const |
| void | setQuality(QMediaRecorder::Quality quality) |
Señal de notificación:
| void | qualityChanged() |
[read-only] recorderState : QMediaRecorder::RecorderState
Esta propiedad contiene el estado actual del grabador multimedia.
La propiedad «state» representa la solicitud del usuario y se modifica de forma sincrónica durante las llamadas a record(), pause() o stop(). El estado de la grabadora también puede cambiar de forma asincrónica cuando falla la grabación.
Funciones de acceso:
| QMediaRecorder::RecorderState | recorderState() const |
Señal de notificación:
| void | recorderStateChanged(QMediaRecorder::RecorderState state) |
[since 6.6] videoBitRate : int
Esta propiedad contiene la velocidad de transmisión del flujo de vídeo comprimido en bits por segundo.
Esta enumeración se introdujo en Qt 6.6.
Funciones de acceso:
| int | videoBitRate() const |
| void | setVideoBitRate(int bitRate) |
Señal de notificación:
| void | videoBitRateChanged() |
[since 6.6] videoFrameRate : qreal
Esta propiedad indica la frecuencia de fotogramas del vídeo utilizada en la codificación.
Si esta propiedad se establece en una velocidad de fotogramas positiva, QMediaRecorder intentará codificar a esa velocidad. Si las velocidades de fotogramas de la fuente de vídeo y del codificador son diferentes, es posible que se omitan o dupliquen fotogramas de la fuente para alcanzar la velocidad de destino.
Si se deja en el valor predeterminado (-1) o se establece en otro valor no positivo, QMediaRecorder intentará tomar la decisión óptima en función de la fuente de vídeo y las limitaciones del códec.
Esta enumeración se introdujo en Qt 6.6.
Funciones de acceso:
| qreal | videoFrameRate() const |
| void | setVideoFrameRate(qreal frameRate) |
Señal de notificador:
| void | videoFrameRateChanged() |
[since 6.6] videoResolution : QSize
Esta propiedad indica la resolución del vídeo codificado.
Si la propiedad « QSize » está vacía, significa que la grabadora elegirá la resolución óptima en función de lo que ofrezca la fuente de vídeo y de las limitaciones del códec.
Esta enumeración se introdujo en Qt 6.6.
Funciones de acceso:
| QSize | videoResolution() const |
| void | setVideoResolution(const QSize &size) |
| void | setVideoResolution(int width, int height) |
Señal del notificador:
| void | videoResolutionChanged() |
Documentación de funciones miembro
QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)
Crea un grabador multimedia. El grabador multimedia es un elemento secundario de parent.
[override virtual noexcept] QMediaRecorder::~QMediaRecorder()
Elimina un objeto de grabación multimedia.
[signal] void QMediaRecorder::actualLocationChanged(const QUrl &location)
Indica que la velocidad de reproducción real ( location ) del soporte grabado ha cambiado. Esta señal suele emitirse al inicio de la grabación.
Nota: Señalde notificación para la propiedad « actualLocation ».
void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)
Añade « metaData » a los medios grabados.
int QMediaRecorder::audioBitRate() const
Devuelve la velocidad de bits del flujo de audio comprimido en bits por segundo.
Nota: Funcióngetter para la propiedad audioBitRate.
Véase también setAudioBitRate().
[signal] void QMediaRecorder::audioBitRateChanged()
Avisa cuando cambia la velocidad de bits de audio de la grabación.
Nota: Señalde notificación para la propiedad « audioBitRate ».
int QMediaRecorder::audioChannelCount() const
Devuelve el número de canales de audio.
Nota: Funcióngetter para la propiedad audioChannelCount.
Véase también ` setAudioChannelCount()`.
[signal] void QMediaRecorder::audioChannelCountChanged()
Avisa cuando cambia el número de canales de audio de grabación.
Nota: Señalde notificación para la propiedad « audioChannelCount ».
int QMediaRecorder::audioSampleRate() const
Devuelve la frecuencia de muestreo de audio en Hz.
Nota: Funcióngetter para la propiedad audioSampleRate.
Véase también ` setAudioSampleRate()`.
[signal] void QMediaRecorder::audioSampleRateChanged()
Emite una señal cuando cambia la frecuencia de muestreo del audio de la grabación.
Nota: Señalde notificación para la propiedad « audioSampleRate ».
QMediaCaptureSession *QMediaRecorder::captureSession() const
Devuelve la sesión de captura multimedia.
[signal] void QMediaRecorder::durationChanged(qint64 duration)
Indica que la propiedad « duration » del medio grabado ha cambiado.
Nota: Señalde notificación para la propiedad « duration ».
QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const
Devuelve el modo de codificación.
Nota: Funcióngetter para la propiedad encodingMode.
Véase también setEncodingMode() y EncodingMode.
[signal] void QMediaRecorder::encodingModeChanged()
Emite una señal cuando cambia el modo de codificación.
Nota: Señalde notificación para la propiedad « encodingMode ».
[signal] void QMediaRecorder::errorOccurred(QMediaRecorder::Error error, const QString &errorString)
Indica que se ha producido un error de « error », y en errorString se incluye una descripción del error.
bool QMediaRecorder::isAvailable() const
Devuelve « true » si el servicio de grabación multimedia está listo para su uso.
[signal] void QMediaRecorder::metaDataChanged()
Indica que los metadatos de un objeto multimedia han cambiado.
Si se modifican varios elementos de metadatos, se emite metaDataChanged() una sola vez.
Nota: Señalde notificación para la propiedad « metaData ».
QIODevice *QMediaRecorder::outputDevice() const
Devuelve el dispositivo de E/S de salida para el contenido multimedia.
Véase también setOutputDevice().
[slot] void QMediaRecorder::pause()
Detiene la grabación.
El estado de la grabadora cambia a « QMediaRecorder::PausedState ».
Dependiendo de la plataforma, es posible que no se admita la pausa de la grabación. En ese caso, el estado de la grabadora no cambia.
[signal] void QMediaRecorder::qualityChanged()
Avisa cuando cambia la calidad de la grabación.
Nota: Señalde notificación para la propiedad « quality ».
[slot] void QMediaRecorder::record()
Inicia la grabación.
Aunque el estado del grabador 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.
Nota: En los dispositivos móviles, la grabación se realizará con la orientación que tenía el dispositivo al llamar a `record` y se bloqueará durante toda la grabación. Para evitar artefactos en la interfaz de usuario, recomendamos mantener la interfaz bloqueada en la misma orientación mientras la grabación esté en curso utilizando la propiedad `contentOrientation` de ` QWindow ` y desbloquearla de nuevo una vez finalizada la grabación.
QMediaRecorder::RecorderState QMediaRecorder::recorderState() const
Devuelve el estado actual del grabador multimedia.
Nota: Funcióngetter para la propiedad recorderState.
Véase también QMediaRecorder::RecorderState.
[signal] void QMediaRecorder::recorderStateChanged(QMediaRecorder::RecorderState state)
Indica que la propiedad « state » de un grabador multimedia ha cambiado.
Nota: Señalde notificación para la propiedad « recorderState ».
void QMediaRecorder::setAudioBitRate(int bitRate)
Establece la resolución de audio bitRate en bits por segundo.
Nota: Funciónde asignación para la propiedad audioBitRate.
Véase también audioBitRate().
void QMediaRecorder::setAudioChannelCount(int channels)
Establece el número de canales de audio channels.
Un valor de -1 indica que la grabadora debe elegir la opción óptima en función de lo que esté disponible en la fuente de audio y de las limitaciones del códec.
Nota: Funciónde asignación para la propiedad ` audioChannelCount`.
Véase también audioChannelCount().
void QMediaRecorder::setAudioSampleRate(int sampleRate)
Establece la « sampleRate » de audio en Hz.
Un valor de « -1 » indica que la grabadora debe elegir la opción óptima en función de lo que ofrezca la fuente de audio y de las limitaciones del códec.
Nota: Funciónde asignación para la propiedad audioSampleRate.
Véase también audioSampleRate().
void QMediaRecorder::setEncodingMode(QMediaRecorder::EncodingMode mode)
Establece el parámetro de codificación « mode ».
Si se establece « ConstantQualityEncoding », se utiliza el parámetro de codificación de calidad y se ignoran las velocidades de bits; en caso contrario, se utilizan las velocidades de bits.
Nota: Funciónde asignación para la propiedad encodingMode.
Véase también « encodingMode()» y « EncodingMode ».
void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)
Establece los metadatos en metaData.
Nota: Para garantizar que los metadatos se configuren correctamente, deben establecerse antes de iniciar la grabación. Una vez iniciada la grabación, cualquier metadato configurado se asociará a la siguiente grabación.
Nota: Funciónde asignación para la propiedad metaData.
Véase también metaData().
void QMediaRecorder::setOutputDevice(QIODevice *device)
Configurar el dispositivo de E/S de salida para el contenido multimedia.
El archivo « device » debe haberse abierto en los modos « WriteOnly » o « ReadWrite » antes de que comience la grabación.
El grabador multimedia no toma el control del device especificado. Si se ha iniciado la grabación, el dispositivo debe mantenerse activo y abierto hasta que se emita la señal recorderStateChanged(StoppedState).
Este método restablece actualLocation inmediatamente, a menos que el device especificado sea null.
Si se asigna un dispositivo de salida grabable a la grabadora, se ignora ` outputLocation ` y no se genera ` actualLocation ` al iniciar la grabación. Este comportamiento puede cambiar en el futuro, por lo que recomendamos configurar una única salida, ya sea ` outputLocation ` o ` outputDevice`.
QMediaRecorder::setOutputDevice Solo es compatible con el backend de FFmpeg.
Véase también ` outputDevice()` y ` outputLocation`.
void QMediaRecorder::setVideoBitRate(int bitRate)
Establece la resolución de vídeo bitRate en bits por segundo.
Nota: Funciónde asignación para la propiedad videoBitRate.
Véase también videoBitRate().
void QMediaRecorder::setVideoFrameRate(qreal frameRate)
Establece la codificación de vídeo frameRate.
Nota: Funciónde asignación para la propiedad videoFrameRate.
Véase también videoFrameRate().
void QMediaRecorder::setVideoResolution(const QSize &size)
Establece la resolución del vídeo codificado en size.
Pasa un objeto ` QSize ` vacío para que la grabadora elija una resolución óptima en función de lo que esté disponible en la fuente de vídeo y de las limitaciones del códec.
Nota: Funciónde asignación para la propiedad videoResolution.
Véase también ` videoResolution()`.
void QMediaRecorder::setVideoResolution(int width, int height)
Establece los valores de « width » y « height » de la resolución del vídeo codificado.
Nota: Funciónde asignación para la propiedad videoResolution.
Esta es una función sobrecargada.
[slot] void QMediaRecorder::stop()
El grabador detendrá la grabación. No obstante, el procesamiento de los datos de vídeo y audio pendientes podría tardar aún algún tiempo. La grabación habrá finalizado cuando el estado del grabador multimedia cambie a « QMediaRecorder::StoppedState ».
int QMediaRecorder::videoBitRate() const
Devuelve la velocidad de bits del flujo de vídeo comprimido en bits por segundo.
Nota: Funcióngetter para la propiedad videoBitRate.
Véase también setVideoBitRate().
[signal] void QMediaRecorder::videoBitRateChanged()
Indica cuándo cambia la tasa de bits de la grabación de vídeo.
Nota: Señalde notificación para la propiedad « videoBitRate ».
qreal QMediaRecorder::videoFrameRate() const
Devuelve la frecuencia de fotogramas de la codificación de vídeo.
Nota: Funcióngetter para la propiedad videoFrameRate.
Véase también ` setVideoFrameRate()`.
[signal] void QMediaRecorder::videoFrameRateChanged()
Avisa cuando cambia la frecuencia de fotogramas de la codificación de vídeo.
Nota: Señalde notificación para la propiedad « videoFrameRate ».
QSize QMediaRecorder::videoResolution() const
Devuelve la resolución del vídeo codificado.
Nota: Funcióngetter para la propiedad videoResolution.
Véase también ` setVideoResolution()`.
[signal] void QMediaRecorder::videoResolutionChanged()
Avisa cuando cambia la resolución de la grabación de vídeo.
Nota: Señalde notificación para la propiedad « videoResolution ».
© 2026 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.