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.
| Constante | Valor | Descripción |
|---|---|---|
QMediaPlayer::NoError | 0 | No se ha producido ningún error. |
QMediaPlayer::ResourceError | 1 | No se ha podido resolver un recurso multimedia. |
QMediaPlayer::FormatError | 2 | El 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::NetworkError | 3 | Se ha producido un error de red. |
QMediaPlayer::AccessDeniedError | 4 | No se dispone de los permisos adecuados para reproducir un recurso multimedia. |
enum QMediaPlayer::Loops
Algunas constantes predefinidas para la propiedad ` loops `.
| Constante | Valor | Descripción |
|---|---|---|
QMediaPlayer::Infinite | -1 | Repetir indefinidamente. |
QMediaPlayer::Once | 1 | Reproduce el archivo multimedia una vez (valor predeterminado). |
enum QMediaPlayer::MediaStatus
Define el estado del contenido multimedia actual de un reproductor multimedia.
| Constante | Valor | Descripción |
|---|---|---|
QMediaPlayer::NoMedia | 0 | No hay ningún contenido multimedia actualmente. El reproductor se encuentra en el estado « StoppedState ». |
QMediaPlayer::LoadingMedia | 1 | Se está cargando el contenido multimedia actual. El reproductor puede encontrarse en cualquier estado. |
QMediaPlayer::LoadedMedia | 2 | El contenido multimedia actual se ha cargado. El reproductor se encuentra en el estado « StoppedState ». |
QMediaPlayer::StalledMedia | 3 | La 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::BufferingMedia | 4 | El 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::BufferedMedia | 5 | El reproductor ha almacenado por completo en el búfer el contenido multimedia actual. El reproductor se encuentra en el estado « PlayingState » o « PausedState ». |
QMediaPlayer::EndOfMedia | 6 | La reproducción ha llegado al final del contenido multimedia actual. El reproductor se encuentra en StoppedState. |
QMediaPlayer::InvalidMedia | 7 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QMediaPlayer::PitchCompensationAvailability::AlwaysOn | 0 | El reproductor multimedia realiza siempre la compensación de tono. |
QMediaPlayer::PitchCompensationAvailability::Available | 1 | El 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::Unavailable | 2 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QMediaPlayer::StoppedState | 0 | El reproductor multimedia no está reproduciendo ningún contenido; la reproducción comenzará desde el inicio de la pista actual. |
QMediaPlayer::PlayingState | 1 | El reproductor multimedia está reproduciendo contenido en este momento. Esto indica lo mismo que la propiedad « playing ». |
QMediaPlayer::PausedState | 2 | El 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:
| void | activeTracksChanged() |
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:
| void | activeTracksChanged() |
[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.