QMediaPlayer Class

player = new QMediaPlayer;
audioOutput = new QAudioOutput;
player->setAudioOutput(audioOutput);
connect(player, &QMediaPlayer::positionChanged, this, &MediaExample::positionChanged);
player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
audioOutput->setVolume(0.5);
player->play();

Documentación de la propiedad

activeAudioTrack : int

Devuelve la pista de audio activa en ese momento.

Por defecto, se elegirá la primera pista de audio disponible.

Establezca index en -1 para desactivar todas las pistas de audio.

Funciones de acceso:

Señal de aviso:

activeSubtitleTrack : int

Devuelve la pista de subtítulos actualmente activa.

Establezca index en -1 para desactivar los subtítulos.

Los subtítulos están desactivados por defecto.

Funciones de acceso:

Señal de aviso:

activeVideoTrack : int

Devuelve la pista de vídeo activa en ese momento.

Por defecto, se elegirá la primera pista de audio disponible.

Establezca index en -1 para desactivar todas las pistas de vídeo.

Funciones de acceso:

Señal de aviso:

[since 6.8] audioBufferOutput : QAudioBufferOutput*

Esta propiedad contiene el búfer de audio de salida utilizado por el reproductor multimedia.

Establece un búfer de audio output para el reproductor multimedia.

Si se especifica QAudioBufferOutput y la fuente multimedia contiene un flujo de audio, el reproductor multimedia, emitirá la señal QAudioBufferOutput::audioBufferReceived con búferes de audio que contienen datos de audio decodificados. Al final del flujo de audio, QMediaPlayer emite un QAudioBuffer vacío.

QMediaPlayer emite los búferes de audio al mismo tiempo que empuja los datos correspondientes a la salida de audio si está especificada. Sin embargo, el sonido puede reproducirse con un pequeño retardo debido a la emisión de búferes de audio.

El formato de los búferes de audio emitidos se toma del output especificado o del flujo de audio coincidente si el output devuelve un formato no válido. Los datos de audio emitidos no se escalan en función de la velocidad de reproducción actual.

Los posibles casos de uso de QAudioBufferOutput con QMediaPlayer podrían ser:

• Visualización de audio. Si la velocidad de reproducción del reproductor multimedia no es 1, puede escalar las dimensiones de la imagen de salida, o el intervalo de actualización de la imagen según los requisitos del visualizador.
• Cualquier procesamiento de sonido AI, por ejemplo, reconocimiento de voz.
• Envío de los datos a una salida de audio externa. Se debe tener en cuenta el cambio de velocidad de reproducción, la sincronización con el vídeo y la descarga manual al parar y buscar. No recomendamos utilizar la salida del buffer de audio para este propósito a menos que tengas una razón de peso para ello.

Esta propiedad se introdujo en Qt 6.8.

Funciones de acceso:

Señal del notificador:

audioOutput : QAudioOutput*

Esta propiedad contiene el dispositivo de salida de audio utilizado por el reproductor multimedia.

La salida de audio actual que se utilizará al reproducir medios. Establecer una nueva salida de audio reemplazará la salida utilizada actualmente.

Establecer esta propiedad a nullptr deshabilitará cualquier salida de audio.

Funciones de acceso:

Señal del notificador:

[read-only] audioTracks : QList<QMediaMetaData>

Lista el conjunto de pistas de audio disponibles dentro del soporte.

La dirección QMediaMetaData devuelta describe las propiedades de las pistas individuales.

Diferentes pistas de audio pueden, por ejemplo, contener audio en diferentes idiomas.

Funciones de acceso:

Señal notificadora:

[read-only] bufferProgress : float

Esta propiedad contiene el porcentaje del buffer temporal que se llena antes de que comience o se reanude la reproducción, desde 0. (vacío) hasta 1. (lleno).

Cuando el objeto reproductor está almacenando en el buffer; esta propiedad contiene el porcentaje del buffer temporal que está lleno. El búfer deberá estar lleno al 100% antes de que la reproducción pueda comenzar o reanudarse, en cuyo momento mediaStatus() devolverá BufferedMedia o BufferingMedia. Si el valor es inferior a 100, mediaStatus() devolverá StalledMedia.

Funciones de acceso:

Señal notificadora:

Véase también mediaStatus().

[read-only] duration : qint64

Esta propiedad contiene la duración del medio actual.

El valor es el tiempo total de reproducción en milisegundos del medio actual. El valor puede cambiar a lo largo del tiempo de vida del objeto QMediaPlayer y puede no estar disponible cuando comienza la reproducción inicial, conéctese a la señal durationChanged() para recibir notificaciones de estado.

Funciones de acceso:

Señal de notificador:

[read-only] error : Error

Esta propiedad contiene una cadena que describe la última condición de error.

Funciones de acceso:

Señal del notificador:

Véase también error().

[read-only] errorString : QString

Esta propiedad contiene una cadena que describe con más detalle la condición de error actual.

Funciones de acceso:

Señal del notificador:

[read-only] hasAudio : bool

Esta propiedad indica si el medio contiene audio.

Funciones de acceso:

Señal del notificador:

[read-only] hasVideo : bool

Esta propiedad indica si el soporte contiene vídeo.

Funciones de acceso:

Señal del notificador:

loops : int

Determina la frecuencia con la que se reproduce el medio antes de que el reproductor se detenga. Establezca QMediaPlayer::Infinite para reproducir en bucle el archivo multimedia actual para siempre.

El valor por defecto es 1. Establecer esta propiedad a 0 no tiene ningún efecto.

Funciones de acceso:

Notificador de señal:

[read-only] mediaStatus : MediaStatus

Esta propiedad contiene el estado del flujo multimedia actual.

El estado del flujo describe cómo está progresando la reproducción del flujo actual.

Por defecto, esta propiedad es QMediaPlayer::NoMedia

Funciones de acceso:

Notificador de señal:

[read-only] metaData : QMediaMetaData

Devuelve los metadatos del medio actual utilizado por el reproductor multimedia.

Los metadatos pueden contener información como el título del vídeo o su fecha de creación.

Funciones de acceso:

Señal de notificación:

[since 6.10] pitchCompensation : bool

Esta propiedad contiene el estado de la compensación de tono del reproductor multimedia.

Indica si la compensación de tono está habilitada. Cuando está habilitada, cambiar la velocidad de reproducción no afectará al tono de la señal de audio.

Por defecto es true si la compensación de tono, está disponible, en caso contrario false.

Esta propiedad se introdujo en Qt 6.10.

Funciones de acceso:

Notificador de señal:

[read-only, since 6.10] pitchCompensationAvailability : const PitchCompensationAvailability

Esta propiedad contiene la disponibilidad de compensación de cabeceo del backend QtMultimedia actual.

Indica la disponibilidad de la compensación de cabeceo de QMediaPlayer en el backend actual.

Para más información, véase QMediaPlayer::PitchCompensationAvailability.

Esta propiedad se introdujo en Qt 6.10.

Funciones de acceso:

[since 6.10] playbackOptions : QPlaybackOptions

Opciones avanzadas de reproducción utilizadas para configurar la reproducción y descodificación de medios.

Esta propiedad expone la API QPlaybackOptions que ofrece un control de bajo nivel de las opciones de reproducción multimedia. Aunque recomendamos encarecidamente confiar en la configuración predeterminada de QMediaPlayer, esta API puede utilizarse para optimizar la reproducción multimedia para casos de uso específicos en los que las opciones predeterminadas no son las ideales.

Las opciones de reproducción surten efecto la próxima vez que se llama a QMediaPlayer::setSource().

Esta propiedad se introdujo en Qt 6.10.

Funciones de acceso:

Señal de notificador:

playbackRate : qreal

Esta propiedad contiene la velocidad de reproducción del medio actual.

Este valor es un multiplicador aplicado a la velocidad de reproducción estándar del medio. Por defecto este valor es 1.0, indicando que el medio se reproduce a la velocidad estándar. Los valores superiores a 1,0 aumentarán la velocidad de reproducción, mientras que los valores entre 0,0 y 1,0 provocarán una reproducción más lenta. No se admiten velocidades de reproducción negativas.

No todos los servicios de reproducción admiten el cambio de la velocidad de reproducción. Se define el marco en cuanto al estado y la calidad del audio y el vídeo durante el avance rápido o el rebobinado.

Funciones de acceso:

Señal de aviso:

[read-only] playbackState : PlaybackState

Devuelve la dirección PlaybackState.

Funciones de acceso:

Señal del notificador:

Véase también playing.

[read-only, since 6.5] playing : bool

Esta propiedad indica si el medio se está reproduciendo.

Esta propiedad se introdujo en Qt 6.5.

Funciones de acceso:

Notifier signal:

Véase también playbackState y PlayingState.

position : qint64

Esta propiedad contiene la posición de reproducción del medio actual.

El valor es la posición de reproducción actual, expresada en milisegundos desde el inicio del medio. Los cambios periódicos en la posición se indicarán con la señal positionChanged().

Si la propiedad seekable es verdadera, esta propiedad puede establecerse en milisegundos.

Funciones de acceso:

Señal notificadora:

[read-only] seekable : bool

Esta propiedad contiene el estado de búsqueda del soporte actual.

Si la búsqueda está soportada esta propiedad será true; false en caso contrario. El estado de esta propiedad puede cambiar a lo largo del tiempo de vida del objeto QMediaPlayer, utilice la señal seekableChanged para monitorizar los cambios.

Funciones de acceso:

Señal de notificador:

source : QUrl

Esta propiedad contiene la fuente multimedia activa utilizada por el objeto reproductor.

El objeto reproductor utilizará QUrl para seleccionar el contenido a reproducir.

Por defecto esta propiedad tiene un valor nulo QUrl.

Establecer esta propiedad a un valor nulo QUrl hará que el reproductor descarte toda la información relacionada con la fuente de medios actual y que cese todas las operaciones de E/S relacionadas con ese medio.

Funciones de acceso:

Señal notificadora:

Véase también QUrl.

[read-only] subtitleTracks : QList<QMediaMetaData>

Lista el conjunto de pistas de subtítulos disponibles dentro del soporte.

La dirección QMediaMetaData devuelta describe las propiedades de las pistas individuales.

Funciones de acceso:

Señal del notificador:

videoOutput : QObject*

Esta propiedad contiene la salida de vídeo a utilizar por el reproductor multimedia.

Un reproductor multimedia sólo puede tener una salida de vídeo conectada, por lo que establecer esta propiedad reemplazará la salida de vídeo conectada anteriormente.

Establecer esta propiedad a nullptr deshabilitará la salida de vídeo.

Funciones de acceso:

Notificador de señal:

[read-only] videoTracks : QList<QMediaMetaData>

Lista el conjunto de pistas de vídeo disponibles dentro del soporte.

La dirección QMediaMetaData devuelta describe las propiedades de las pistas individuales.

Funciones de acceso:

Señal del notificador: