En esta página

MediaRecorder QML Type

Para los soportes de codificación y grabación generados en CaptureSession. Más...

Import Statement: import QtMultimedia
In C++: QMediaRecorder

Propiedades

Señales

Métodos

Descripción detallada

Utiliza el elemento MediaRecorder dentro de un CaptureSession para codificar y grabar:

  • Audio capturado desde una interfaz de audio (como un micrófono o una entrada de línea).
  • Vídeo capturado desde una cámara, la pantalla o la ventana de una aplicación.

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 Camera, ScreenCapture o WindowCapture genera fotogramas de vídeo más rápido de lo que MediaRecorder puede codificarlos y grabarlos, es posible que el grabador 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.

El código siguiente muestra una sesión de captura sencilla que incluye un MediaRecorder utilizando la cámara predeterminada y la entrada de audio predeterminada.

CaptureSession {
    id: captureSession
    camera: Camera {
        id: camera
        active: true
    }
    audioInput: AudioInput {}
    recorder: MediaRecorder {
        id: recorder
    }
}

El código siguiente muestra cómo se puede iniciar y detener la grabación.

CameraButton {
    text: "Record"
    visible: recorder.recorderState !== MediaRecorder.RecordingState
    onClicked: recorder.record()
}

CameraButton {
    id: stopButton
    text: "Stop"
    visible: recorder.recorderState === MediaRecorder.RecordingState
    onClicked: recorder.stop()
}

Véase también CaptureSession, Camera, ScreenCapture, WindowCapture, AudioInput y ImageCapture.

Documentación sobre la propiedad

actualLocation : url [read-only]

La ubicación real del último contenido multimedia.

La ubicación real se restablece cuando se asigna una nueva dirección outputLocation. Al invocar record(), el grabador genera la ubicación real basándose en las siguientes reglas.

  • Si outputLocation está vacío, es un directorio o un archivo sin extensión, la grabadora genera la extensión adecuada en función del formato multimedia seleccionado y de los tipos MIME del sistema.
  • Si outputLocation es 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.
  • La grabadora genera la ubicación real antes de generar el archivo « recorderStateChanged(RecordingState) ».

audioBitRate : int [since 6.6]

Esta propiedad contiene la velocidad de transmisión del flujo de audio comprimido en bits por segundo.

Esta propiedad se introdujo en Qt 6.6.

audioChannelCount : int [since 6.6]

Esta propiedad indica el número de canales de audio.

Esta propiedad se introdujo en Qt 6.6.

audioSampleRate : int [since 6.6]

Esta propiedad contiene la frecuencia de muestreo de audio en Hz.

Esta propiedad se introdujo en Qt 6.6.

duration : qint64 [read-only]

Esta propiedad contiene la duración de la grabación en milisegundos.

encodingMode : enumeration [since 6.6]

Esta propiedad almacena el modo de codificación.

Esta propiedad se introdujo en Qt 6.6.

Véase también QMediaRecorder::EncodingMode.

error : enumeration [read-only]

Esta propiedad contiene el estado actual de error de la grabadora multimedia.

ConstanteDescripción
MediaRecorder.NoErrorNo se encuentra en estado de error.
MediaRecorder.ResourceErrorNo hay suficientes recursos del sistema
MediaRecorder.FormatErrorEl formato actual no es compatible.
MediaRecorder.OutOfSpaceErrorNo queda espacio libre en el dispositivo.
MediaRecorder.LocationNotWriteableLa ubicación de salida no es escribible.

errorString : string [read-only]

Esta propiedad contiene una cadena que describe el estado actual del error.

Véase también error.

mediaFormat : mediaFormat

Esta propiedad contiene el MediaFormat actual de la grabadora.

metaData : mediaMetaData

Esta propiedad contiene los metadatos asociados a la grabación.

Cuando se inicia una grabación, cualquier metadato asignado se adjuntará a dicha grabación.

Nota: Asegúrese de que los metadatos estén asignados correctamente asignándolos antes de iniciar la grabación.

Véase también mediaMetaData.

outputLocation : url

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

Véanse también actualLocation y errorOccurred().

quality : enumeration

Enumera los niveles de codificación de calidad.

ConstanteValor
MediaRecorder.VeryLowQuality
MediaRecorder.LowQuality
MediaRecorder.NormalQuality
MediaRecorder.HighQuality
MediaRecorder.VeryHighQuality

recorderState : enumeration [read-only]

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(). RecorderState también puede cambiar de forma asíncrona cuando falla la grabación.

ConstanteDescripción
MediaRecorder.StoppedStateEl grabador no está activo.
MediaRecorder.RecordingStateSe ha solicitado la grabación.
MediaRecorder.PausedStateLa grabadora está en pausa.

videoBitRate : int [since 6.6]

Esta propiedad contiene la velocidad de transmisión del flujo de vídeo comprimido en bits por segundo.

Esta propiedad se introdujo en Qt 6.6.

videoFrameRate : real [since 6.6]

Esta propiedad indica la frecuencia de fotogramas del vídeo utilizada en la codificación.

Si esta propiedad se establece en una frecuencia de fotogramas positiva, MediaRecorder intentará codificar a esa frecuencia. Si las frecuencias de fotogramas de la fuente de vídeo y del codificador son diferentes, es posible que se omitan o se dupliquen fotogramas de la fuente para alcanzar la frecuencia de destino.

Si se deja en el valor predeterminado (-1) o se establece en otro valor no positivo, MediaRecorder intentará tomar la decisión óptima en función de la fuente de vídeo y las limitaciones del códec.

Esta propiedad se introdujo en Qt 6.6.

videoResolution : Size [since 6.6]

Esta propiedad contiene la resolución del vídeo codificado.

Establece un valor vacío en «Size» 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.

Esta propiedad se introdujo en Qt 6.6.

Documentación de señales

actualLocationChanged(const QUrl &location)

Indica que la « location » real del soporte grabado ha cambiado.

Esta señal suele emitirse cuando comienza la grabación.

Nota: El controlador correspondiente es onActualLocationChanged.

durationChanged(qint64 duration)

Indica que el duration del soporte grabado ha cambiado.

Nota: El controlador correspondiente es onDurationChanged.

errorOccurred(Error error, const QString &errorString)

Indica que se ha producido un error de « error ».

El errorString contiene una descripción del error.

Nota: El gestor correspondiente es onErrorOccurred.

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: El controlador correspondiente es ` onMetaDataChanged`.

recorderStateChanged(RecorderState state)

Indica que el « state » de un grabador multimedia ha cambiado.

Nota: El controlador correspondiente es onRecorderStateChanged.

Documentación del método

void 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.

void record()

Inicia la grabación.

Aunque el estado de la grabadora cambia inmediatamente a « MediaRecorder.RecordingState », la grabación puede iniciarse 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 tuviera el dispositivo al llamar a `record` y permanecerá bloqueada mientras dure la grabación. Para evitar artefactos en la interfaz de usuario, recomendamos mantener la interfaz de usuario bloqueada en la misma orientación mientras la grabación esté en curso utilizando la propiedad `contentOrientation` de la ventana y desbloquearla de nuevo una vez finalizada la grabación.

void stop()

Detiene la grabación.

La grabadora detendrá la grabación. No obstante, el procesamiento de los datos de vídeo y audio pendientes puede tardar aún algún tiempo. La grabación habrá finalizado cuando el estado de la grabadora multimedia cambie a « QMediaRecorder::StoppedState ».

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