En esta página

QMediaPlayer Class

La clase QMediaPlayer permite reproducir archivos multimedia. Más información...

Encabezado: #include <QMediaPlayer>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
En QML: MediaPlayer
Heredan de: QObject

Tipos públicos

enum Error { NoError, ResourceError, FormatError, NetworkError, AccessDeniedError }
enum Loops { Infinite, Once }
enum MediaStatus { NoMedia, LoadingMedia, LoadedMedia, StalledMedia, BufferingMedia, …, InvalidMedia }
(since 6.10) enum class PitchCompensationAvailability { AlwaysOn, Available, Unavailable }
enum PlaybackState { StoppedState, PlayingState, PausedState }

Propiedades

Funciones públicas

QMediaPlayer(QObject *parent = nullptr)
virtual ~QMediaPlayer() override
int activeAudioTrack() const
int activeSubtitleTrack() const
int activeVideoTrack() const
QAudioBufferOutput *audioBufferOutput() const
QAudioOutput *audioOutput() const
QList<QMediaMetaData> audioTracks() const
float bufferProgress() const
QMediaTimeRange bufferedTimeRange() const
qint64 duration() const
QMediaPlayer::Error error() const
QString errorString() const
bool hasAudio() const
bool hasVideo() const
bool isAvailable() const
bool isPlaying() const
bool isSeekable() const
int loops() const
QMediaPlayer::MediaStatus mediaStatus() const
QMediaMetaData metaData() const
(since 6.10) bool pitchCompensation() const
(since 6.10) QMediaPlayer::PitchCompensationAvailability pitchCompensationAvailability() const
QPlaybackOptions playbackOptions() const
qreal playbackRate() const
QMediaPlayer::PlaybackState playbackState() const
qint64 position() const
void setActiveAudioTrack(int index)
void setActiveSubtitleTrack(int index)
void setActiveVideoTrack(int index)
void setAudioBufferOutput(QAudioBufferOutput *output)
void setAudioOutput(QAudioOutput *output)
void setLoops(int loops)
void setVideoOutput(QObject *)
void setVideoSink(QVideoSink *sink)
QUrl source() const
const QIODevice *sourceDevice() const
QList<QMediaMetaData> subtitleTracks() const
QObject *videoOutput() const
QVideoSink *videoSink() const
QList<QMediaMetaData> videoTracks() const

Ranuras públicas

void pause()
void play()
void resetPlaybackOptions()
(since 6.10) void setPitchCompensation(bool enabled) const
void setPlaybackOptions(const QPlaybackOptions &options)
void setPlaybackRate(qreal rate)
void setPosition(qint64 position)
void setSource(const QUrl &source)
void setSourceDevice(QIODevice *device, const QUrl &sourceUrl = QUrl())
void stop()

Señales

void activeTracksChanged()
void audioBufferOutputChanged()
void audioOutputChanged()
void bufferProgressChanged(float filled)
void durationChanged(qint64 duration)
void errorChanged()
void errorOccurred(QMediaPlayer::Error error, const QString &errorString)
void hasAudioChanged(bool available)
void hasVideoChanged(bool videoAvailable)
void loopsChanged()
void mediaStatusChanged(QMediaPlayer::MediaStatus status)
void metaDataChanged()
void pitchCompensationChanged(bool)
void playbackOptionsChanged()
void playbackRateChanged(qreal rate)
void playbackStateChanged(QMediaPlayer::PlaybackState newState)
void playingChanged(bool playing)
void positionChanged(qint64 position)
void seekableChanged(bool seekable)
void sourceChanged(const QUrl &media)
void tracksChanged()
void videoOutputChanged()

Descripción detallada

La clase QMediaPlayer es una clase de alto nivel para la reproducción de contenidos multimedia. Se puede utilizar para reproducir archivos multimedia de audio o vídeo. El contenido que se va a reproducir se especifica como un objeto ` QUrl `.

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();

QVideoWidget Se puede utilizar con QMediaPlayer para la reproducción de vídeo.

Véase también ` QVideoWidget`.

Documentación de los tipos de miembros

enum QMediaPlayer::Error

Define una condición de error del reproductor multimedia.

ConstanteValorDescripción
QMediaPlayer::NoError0No se ha producido ningún error.
QMediaPlayer::ResourceError1No se ha podido resolver un recurso multimedia.
QMediaPlayer::FormatError2El formato de un recurso multimedia no es (totalmente) compatible. Es posible que la reproducción siga siendo posible, pero sin el componente de audio o vídeo.
QMediaPlayer::NetworkError3Se ha producido un error de red.
QMediaPlayer::AccessDeniedError4No se dispone de los permisos adecuados para reproducir un recurso multimedia.

enum QMediaPlayer::Loops

Algunas constantes predefinidas para la propiedad ` loops `.

ConstanteValorDescripción
QMediaPlayer::Infinite-1Repetir indefinidamente.
QMediaPlayer::Once1Reproduce el archivo multimedia una vez (valor predeterminado).

enum QMediaPlayer::MediaStatus

Define el estado del contenido multimedia actual de un reproductor multimedia.

ConstanteValorDescripción
QMediaPlayer::NoMedia0No hay ningún contenido multimedia actualmente. El reproductor se encuentra en el estado « StoppedState ».
QMediaPlayer::LoadingMedia1Se está cargando el contenido multimedia actual. El reproductor puede encontrarse en cualquier estado.
QMediaPlayer::LoadedMedia2El contenido multimedia actual se ha cargado. El reproductor se encuentra en el estado « StoppedState ».
QMediaPlayer::StalledMedia3La reproducción del contenido multimedia actual se ha detenido debido a una falta de almacenamiento en búfer o a alguna otra interrupción temporal. El reproductor se encuentra en el estado « PlayingState » o « PausedState ».
QMediaPlayer::BufferingMedia4El reproductor está almacenando datos en el búfer, pero ya dispone de datos suficientes para que la reproducción continúe en el futuro inmediato. El reproductor se encuentra en el estado « PlayingState » o « PausedState ».
QMediaPlayer::BufferedMedia5El reproductor ha almacenado por completo en el búfer el contenido multimedia actual. El reproductor se encuentra en el estado « PlayingState » o « PausedState ».
QMediaPlayer::EndOfMedia6La reproducción ha llegado al final del contenido multimedia actual. El reproductor se encuentra en StoppedState.
QMediaPlayer::InvalidMedia7El contenido multimedia actual no se puede reproducir. El reproductor se encuentra en el estado « StoppedState ».

[since 6.10] enum class QMediaPlayer::PitchCompensationAvailability

Disponibilidad de la compensación de tono.

Los distintos backends se comportan de forma diferente en lo que respecta a la compensación de tono al cambiar la velocidad de reproducción.

ConstanteValorDescripción
QMediaPlayer::PitchCompensationAvailability::AlwaysOn0El reproductor multimedia realiza siempre la compensación de tono.
QMediaPlayer::PitchCompensationAvailability::Available1El reproductor multimedia puede configurarse para utilizar la compensación de tono. Si la compensación de tono está disponible en la plataforma actual, estará activada por defecto, pero los usuarios pueden desactivarla si es necesario.
QMediaPlayer::PitchCompensationAvailability::Unavailable2El reproductor multimedia no puede realizar la compensación de tono en la plataforma actual.

Esta enumeración se introdujo en Qt 6.10.

enum QMediaPlayer::PlaybackState

Define el estado actual de un reproductor multimedia.

ConstanteValorDescripción
QMediaPlayer::StoppedState0El reproductor multimedia no está reproduciendo ningún contenido; la reproducción comenzará desde el inicio de la pista actual.
QMediaPlayer::PlayingState1El reproductor multimedia está reproduciendo contenido en este momento. Esto indica lo mismo que la propiedad « playing ».
QMediaPlayer::PausedState2El reproductor multimedia ha pausado la reproducción; la reproducción de la pista actual se reanudará desde la posición en la que se detuvo.

Documentación de la propiedad

activeAudioTrack : int

Devuelve la pista de audio activa en ese momento.

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

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

Funciones de acceso:

int activeAudioTrack() const
void setActiveAudioTrack(int index)

Señal de notificación:

void activeTracksChanged()

activeSubtitleTrack : int

Devuelve la pista de subtítulos activa en ese momento.

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

Los subtítulos están desactivados por defecto.

Funciones de acceso:

int activeSubtitleTrack() const
void setActiveSubtitleTrack(int index)

Señal de notificación:

activeVideoTrack : int

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

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

Establece « index » en « -1 » para desactivar todas las pistas de vídeo.

Funciones de acceso:

int activeVideoTrack() const
void setActiveVideoTrack(int index)

Señal de notificación:

[since 6.8] audioBufferOutput : QAudioBufferOutput*

Esta propiedad contiene el búfer de audio de salida que utiliza 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 descodificados. Al final del flujo de audio, « QMediaPlayer » emite un « QAudioBuffer » vacío.

QMediaPlayer emite los búferes de audio al mismo tiempo que envía los datos correspondientes a la salida de audio, si esta se ha especificado. Sin embargo, el sonido puede reproducirse con un ligero retraso debido al almacenamiento en búferes de audio.

El formato de los búferes de audio emitidos se toma del output especificado o del flujo de audio correspondiente 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.

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

  • Visualización de audio. Si la velocidad de reproducción del reproductor multimedia no es « 1 », se pueden ajustar 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 mediante IA, por ejemplo, el reconocimiento de voz.
  • Envío de los datos a una salida de audio externa. Se debe tener en cuenta el cambio de la velocidad de reproducción, la sincronización con el vídeo y el vaciado manual al detener y buscar. No recomendamos utilizar la salida del búfer de audio para este fin, a menos que tengas una razón de peso para ello.

Esta enumeración se introdujo en Qt 6.8.

Funciones de acceso:

QAudioBufferOutput *audioBufferOutput() const
void setAudioBufferOutput(QAudioBufferOutput *output)

Señal de notificador:

void audioBufferOutputChanged()

audioOutput : QAudioOutput*

Esta propiedad indica el dispositivo de salida de audio que utiliza el reproductor multimedia.

La salida de audio actual que se utilizará al reproducir contenido multimedia. Al establecer una nueva salida de audio, se sustituirá la salida utilizada actualmente.

Si se establece esta propiedad en « nullptr », se desactivará cualquier salida de audio.

Funciones de acceso:

QAudioOutput *audioOutput() const
void setAudioOutput(QAudioOutput *output)

Señal de notificación:

void audioOutputChanged()

[read-only] audioTracks : QList<QMediaMetaData>

Muestra el conjunto de pistas de audio disponibles en el archivo multimedia.

El objeto « QMediaMetaData » devuelto describe las propiedades de cada pista.

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

Funciones de acceso:

QList<QMediaMetaData> audioTracks() const

Señal de notificación:

void tracksChanged()

[read-only] bufferProgress : float

Esta propiedad contiene el porcentaje del búfer temporal que se ha llenado 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 búfer, esta propiedad indica el porcentaje del búfer temporal que está lleno. El búfer deberá estar lleno al 100 % antes de que pueda iniciarse o reanudarse la reproducción; en ese momento, mediaStatus() devolverá BufferedMedia o BufferingMedia. Si el valor es inferior a 100, mediaStatus() devolverá StalledMedia.

Funciones de acceso:

float bufferProgress() const

Señal de notificador:

void bufferProgressChanged(float filled)

Véase también mediaStatus().

[read-only] duration : qint64

Esta propiedad contiene la duración del archivo multimedia actual.

El valor corresponde al tiempo total de reproducción, en milisegundos, del contenido multimedia actual. El valor puede variar a lo largo de la vida útil del objeto ` QMediaPlayer ` y es posible que no esté disponible al inicio de la reproducción; conéctate a la señal ` durationChanged()` para recibir notificaciones de estado.

Funciones de acceso:

qint64 duration() const

Señal de notificación:

void durationChanged(qint64 duration)

[read-only] error : Error

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

Funciones de acceso:

QMediaPlayer::Error error() const

Señal de notificación:

void errorChanged()

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:

QString errorString() const

Señal de notificación:

void errorChanged()

[read-only] hasAudio : bool

Esta propiedad indica si el archivo multimedia contiene audio.

Funciones de acceso:

bool hasAudio() const

Señal de notificación:

void hasAudioChanged(bool available)

[read-only] hasVideo : bool

Esta propiedad indica si el archivo multimedia contiene vídeo.

Funciones de acceso:

bool hasVideo() const

Señal de notificación:

void hasVideoChanged(bool videoAvailable)

loops : int

Determina cuántas veces se reproduce el archivo multimedia antes de que el reproductor se detenga. Establece el valor en « QMediaPlayer::Infinite » para reproducir el archivo multimedia actual en bucle de forma indefinida.

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

Funciones de acceso:

int loops() const
void setLoops(int loops)

Señal de notificación:

void loopsChanged()

[read-only] mediaStatus : MediaStatus

Esta propiedad contiene el estado de la transmisión multimedia actual.

El estado de la transmisión describe cómo avanza la reproducción de la transmisión actual.

Por defecto, esta propiedad es QMediaPlayer::NoMedia

Funciones de acceso:

QMediaPlayer::MediaStatus mediaStatus() const

Señal de notificación:

void mediaStatusChanged(QMediaPlayer::MediaStatus status)

[read-only] metaData : QMediaMetaData

Devuelve los metadatos del contenido multimedia actual que está reproduciendo el reproductor multimedia.

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

Nota: La implementación de Windows solo proporciona metadatos para los archivos multimedia ubicados en el sistema de archivos local.

Funciones de acceso:

QMediaMetaData metaData() const

Señal de notificación:

void metaDataChanged()

[since 6.10] pitchCompensation : bool

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

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

Nota: La compensación de tono aumentará la carga de la CPU del QMediaPlayer.

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

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

bool pitchCompensation() const
void setPitchCompensation(bool enabled) const

Señal del notificador:

void pitchCompensationChanged(bool)

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

Esta propiedad indica si la compensación de tono está disponible en el backend actual de QtMultimedia.

Indica si la función de compensación de tono de « QMediaPlayer » está disponible en el backend actual.

Nota: Losdistintos backends pueden tener un comportamiento diferente.

Para obtener más información, consulta QMediaPlayer::PitchCompensationAvailability.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

QMediaPlayer::PitchCompensationAvailability pitchCompensationAvailability() const

[since 6.10] playbackOptions : QPlaybackOptions

Opciones avanzadas de reproducción que se utilizan para configurar la reproducción y la decodificación de contenidos multimedia.

Esta propiedad expone la API ` QPlaybackOptions `, que permite un control de bajo nivel sobre las opciones de reproducción multimedia. Aunque recomendamos encarecidamente utilizar la configuración predeterminada de ` QMediaPlayer`, esta API puede utilizarse para optimizar la reproducción multimedia en casos de uso específicos en los que las opciones predeterminadas no sean las más adecuadas.

Las opciones de reproducción surtirán efecto la próxima vez que se llame a ` QMediaPlayer::setSource()`.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

QPlaybackOptions playbackOptions() const
void setPlaybackOptions(const QPlaybackOptions &options)
void resetPlaybackOptions()

Señal de notificador:

void playbackOptionsChanged()

playbackRate : qreal

Esta propiedad indica la velocidad de reproducción del archivo multimedia actual.

Este valor es un multiplicador que se aplica a la velocidad de reproducción estándar del contenido multimedia. Por defecto, este valor es 1,0, lo que indica que el contenido se reproduce a la velocidad estándar. Los valores superiores a 1,0 aumentan la velocidad de reproducción, mientras que los valores entre 0,0 y 1,0 dan lugar a 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. El marco de trabajo define el estado y la calidad del audio y el vídeo durante el avance rápido o el rebobinado.

Funciones de acceso:

qreal playbackRate() const
void setPlaybackRate(qreal rate)

Señal de notificación:

void playbackRateChanged(qreal rate)

[read-only] playbackState : PlaybackState

Devuelve el objeto ` PlaybackState`.

Funciones de acceso:

QMediaPlayer::PlaybackState playbackState() const

Señal de notificador:

void playbackStateChanged(QMediaPlayer::PlaybackState newState)

Véase también playing.

[read-only, since 6.5] playing : bool

Esta propiedad indica si el contenido multimedia se está reproduciendo.

Esta enumeración se introdujo en Qt 6.5.

Funciones de acceso:

bool isPlaying() const

Señal de notificación:

void playingChanged(bool playing)

Véase también playbackState y PlayingState.

position : qint64

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

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

Si la propiedad « seekable » es «true», esta propiedad se puede establecer en milisegundos.

Funciones de acceso:

qint64 position() const
void setPosition(qint64 position)

Señal de notificación:

void positionChanged(qint64 position)

[read-only] seekable : bool

Esta propiedad indica si es posible avanzar o retroceder en el contenido multimedia actual

Si se admite el desplazamiento, esta propiedad tendrá el valor «true»; en caso contrario, «false». El estado de esta propiedad puede cambiar a lo largo de la vida útil del objeto ` QMediaPlayer `; utilice la señal ` seekableChanged ` para supervisar los cambios.

Funciones de acceso:

bool isSeekable() const

Señal de notificación:

void seekableChanged(bool seekable)

source : QUrl

Esta propiedad contiene la fuente multimedia activa que está utilizando el objeto reproductor.

El objeto reproductor utilizará la propiedad « QUrl » para seleccionar el contenido que se va a reproducir.

Por defecto, esta propiedad tiene un QUrl nulo.

Si se establece esta propiedad en un ` QUrl ` nulo, el reproductor descartará toda la información relacionada con la fuente multimedia actual y detendrá todas las operaciones de E/S relacionadas con dicha fuente.

Funciones de acceso:

QUrl source() const
void setSource(const QUrl &source)

Señal de notificación:

void sourceChanged(const QUrl &media)

Véase también QUrl.

[read-only] subtitleTracks : QList<QMediaMetaData>

Muestra el conjunto de pistas de subtítulos disponibles en el archivo multimedia.

El objeto ` QMediaMetaData ` devuelto describe las propiedades de cada pista.

Funciones de acceso:

QList<QMediaMetaData> subtitleTracks() const

Señal de notificación:

void tracksChanged()

videoOutput : QObject*

Esta propiedad indica la salida de vídeo que utilizará el reproductor multimedia.

Un reproductor multimedia solo puede tener una salida de vídeo conectada, por lo que al configurar esta propiedad se sustituirá la salida de vídeo conectada anteriormente.

Si se establece esta propiedad en « nullptr », se desactivará la salida de vídeo.

Funciones de acceso:

QObject *videoOutput() const
void setVideoOutput(QObject *)

Señal de notificación:

void videoOutputChanged()

[read-only] videoTracks : QList<QMediaMetaData>

Enumera el conjunto de pistas de vídeo disponibles en el archivo multimedia.

El objeto ` QMediaMetaData ` devuelto describe las propiedades de cada pista.

Funciones de acceso:

QList<QMediaMetaData> videoTracks() const

Señal de notificación:

void tracksChanged()

Documentación de las funciones de miembro

[explicit] QMediaPlayer::QMediaPlayer(QObject *parent = nullptr)

Crea una instancia de QMediaPlayer como elemento secundario de parent.

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

Destruye el objeto del jugador.

float QMediaPlayer::bufferProgress() const

Devuelve un número comprendido entre 0 y 1 al almacenar datos en el búfer.

0 significa que no hay datos almacenados en el búfer disponibles; en este caso, la reproducción suele detenerse. La reproducción se reanudará una vez que el búfer alcance el valor 1, lo que significa que se han almacenado suficientes datos para poder reanudar la reproducción.

La función bufferProgress() siempre devolverá 1 para los archivos locales.

Nota: Funcióngetter para la propiedad bufferProgress.

[signal] void QMediaPlayer::bufferProgressChanged(float filled)

Indica el tamaño del búfer local filled como un número comprendido entre 0 y 1.

Nota: Señalde notificador para la propiedad bufferProgress.

QMediaTimeRange QMediaPlayer::bufferedTimeRange() const

Devuelve un objeto ` QMediaTimeRange ` que describe los datos almacenados actualmente en el búfer.

Al transmitir contenido multimedia desde una fuente remota, es posible que diferentes partes del archivo multimedia estén disponibles localmente. El objeto ` QMediaTimeRange ` devuelto describe los intervalos de tiempo que se encuentran almacenados en el búfer y están disponibles para su reproducción inmediata.

Véase también QMediaTimeRange.

qint64 QMediaPlayer::duration() const

Devuelve la duración del archivo multimedia actual en milisegundos.

Devuelve 0 si el reproductor multimedia no dispone de un archivo multimedia o una transmisión válidos. En el caso de las transmisiones en directo, la duración suele variar durante la reproducción a medida que se dispone de más datos.

Nota: Funcióngetter para la propiedad «duration».

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

Indica que la duración del contenido ha cambiado a duration, expresada en milisegundos.

Nota: Señalde notificación para la propiedad duration.

QMediaPlayer::Error QMediaPlayer::error() const

Devuelve el estado de error actual.

Nota: Funcióngetter para la propiedad «error».

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

Indica que se ha producido una condición de « error », y en errorString se incluye una descripción del error.

Véase también errorString().

[signal] void QMediaPlayer::hasAudioChanged(bool available)

Indica que la disponibilidad del contenido de audio ha cambiado a « available ».

Nota: Señalde notificación para la propiedad hasAudio.

[signal] void QMediaPlayer::hasVideoChanged(bool videoAvailable)

Indica que la disponibilidad del contenido visual ha cambiado a videoAvailable.

Nota: Señalde Notifier para la propiedad hasVideo.

bool QMediaPlayer::isAvailable() const

Devuelve «true» si el reproductor multimedia es compatible con esta plataforma.

bool QMediaPlayer::isSeekable() const

Devuelve «true» si el contenido multimedia permite el desplazamiento. La mayoría de los archivos multimedia basados en archivos permiten el desplazamiento, pero las transmisiones en directo no suelen hacerlo.

Nota: Funcióngetter para la propiedad seekable.

Véase también position.

[signal] void QMediaPlayer::mediaStatusChanged(QMediaPlayer::MediaStatus status)

Indica que ha cambiado el valor de « status » del medio actual.

Nota: Señalde notificador para la propiedad « mediaStatus ».

Véase también ` mediaStatus()`.

[slot] void QMediaPlayer::pause()

Pausar la reproducción de la fuente actual.

Véase también play() y stop().

[since 6.10] bool QMediaPlayer::pitchCompensation() const

Devuelve el estado de la compensación de tono.

Nota: Funcióngetter para la propiedad pitchCompensation.

Esta función se introdujo en Qt 6.10.

Véase también ` setPitchCompensation()`.

[since 6.10] QMediaPlayer::PitchCompensationAvailability QMediaPlayer::pitchCompensationAvailability() const

Devuelve la disponibilidad de la compensación de tono del backend actual.

Nota: Funcióngetter para la propiedad pitchCompensationAvailability.

Esta función se introdujo en Qt 6.10.

[slot] void QMediaPlayer::play()

Iniciar o reanudar la reproducción de la fuente actual.

Véase también pause() y stop().

qreal QMediaPlayer::playbackRate() const

Devuelve la velocidad de reproducción actual.

Nota: Funcióngetter para la propiedad playbackRate.

Véase también setPlaybackRate().

[signal] void QMediaPlayer::playbackRateChanged(qreal rate)

Indica que la propiedad « playbackRate » ha cambiado a « rate ».

Nota: Señaldel notificador para la propiedad playbackRate.

qint64 QMediaPlayer::position() const

Devuelve la posición actual dentro del archivo multimedia que se está reproduciendo, en milisegundos.

Devuelve 0 si el reproductor multimedia no dispone de un archivo multimedia o una transmisión válidos. En el caso de las transmisiones en directo, la duración suele variar durante la reproducción a medida que se dispone de más datos.

Nota: Funcióngetter para la propiedad «position».

Véase también setPosition().

[signal] void QMediaPlayer::positionChanged(qint64 position)

Indica que la posición del contenido ha cambiado a position, expresada en milisegundos.

Nota: Señalde notificación para la propiedad position.

[signal] void QMediaPlayer::seekableChanged(bool seekable)

Indica que el estado « seekable » del objeto reproductor ha cambiado.

Nota: Señalde Notifier para la propiedad « seekable ».

[slot, since 6.10] void QMediaPlayer::setPitchCompensation(bool enabled) const

Establece el estado (enabled o desactivado) de la compensación de tono. Esto solo surte efecto si la compensación de tono del audio se puede configurar en el backend en tiempo de ejecución.

Nota: Funciónde asignación para la propiedad pitchCompensation.

Esta función se introdujo en Qt 6.10.

Véase también pitchCompensation().

[slot] void QMediaPlayer::setSource(const QUrl &source)

Establece el source actual.

Si se establece el QUrl en nulo, el reproductor descartará toda la información relativa a la fuente multimedia actual y detendrá todas las operaciones de E/S relacionadas con dicha fuente. Al establecer el , se detendrá la reproducción.

Nota: Esta función devuelve un resultado inmediatamente después de registrar la fuente especificada del contenido multimedia. No espera a que finalice la carga del contenido ni comprueba si se han producido errores. Se recomienda estar atento a las señales ` mediaStatusChanged()` y ` error()` para recibir una notificación cuando se haya cargado el contenido multimedia y cuando se produzca un error durante la carga.

Nota: FFmpeg , utilizado por el backend multimedia FFmpeg, restringe el uso de protocolos anidados por motivos de seguridad. En entornos controlados en los que todas las entradas son fiables, la lista de protocolos aprobados se puede anular utilizando la variable de entorno QT_FFMPEG_PROTOCOL_WHITELIST. Esta variable de entorno forma parte de la API privada de Qt y puede cambiar entre versiones de parche sin previo aviso.

Nota: Funciónde configuración para la propiedad source.

Véase también source().

[slot] void QMediaPlayer::setSourceDevice(QIODevice *device, const QUrl &sourceUrl = QUrl())

Establece la fuente actual device.

Los datos multimedia se leerán desde device. Se puede proporcionar el sourceUrl para obtener información adicional sobre el contenido multimedia, el tipo MIME, etc. El device debe estar abierto y ser legible.

En macOS, el archivo device también debe permitir el desplazamiento.

Nota: Esta función devuelve un resultado inmediatamente después de grabar la fuente especificada del contenido multimedia. No espera a que el contenido termine de cargarse y no comprueba si hay errores. Escucha las señales mediaStatusChanged() y error() para recibir una notificación cuando se haya cargado el contenido multimedia y en caso de que se produzca un error durante la carga.

Véase también sourceDevice().

void QMediaPlayer::setVideoSink(QVideoSink *sink)

Establece ` sink ` como la instancia de ` QVideoSink ` desde la que se recuperarán los datos de vídeo.

Véase también videoSink().

[signal] void QMediaPlayer::sourceChanged(const QUrl &media)

Indica que la fuente multimedia se ha cambiado a media.

Nota: Señalde notificación para la propiedad source.

const QIODevice *QMediaPlayer::sourceDevice() const

Devuelve la fuente de la secuencia de datos multimedia.

Esto solo es válido si se ha pasado una secuencia a setSource().

Véase también setSourceDevice() y setSource().

[slot] void QMediaPlayer::stop()

Detén la reproducción y vuelve al principio.

Véase también play() y pause().

[signal] void QMediaPlayer::tracksChanged()

Nota: Señalde notificador para las propiedades audioTracks, subtitleTracks y videoTracks.

QVideoSink *QMediaPlayer::videoSink() const

Devuelve la instancia de ` QVideoSink `.

Véase también setVideoSink().

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