En esta página

QPlaybackOptions Class

La clase QPlaybackOptions permite un control de bajo nivel de las opciones de reproducción multimedia. Más información...

Encabezado: #include <QPlaybackOptions>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
Desde: Qt 6.10
En QML: PlaybackOptions

Tipos públicos

(since 6.10) enum class PlaybackIntent { Playback, LowLatencyStreaming }

Propiedades

Funciones públicas

QPlaybackOptions(QPlaybackOptions &&)
std::chrono::milliseconds networkTimeout() const
QPlaybackOptions::PlaybackIntent playbackIntent() const
qsizetype probeSize() const
void resetNetworkTimeout()
void resetPlaybackIntent()
void resetProbeSize()
void setNetworkTimeout(std::chrono::milliseconds timeout)
void setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent)
void setProbeSize(qsizetype probeSizeBytes)

Descripción detallada

QPlaybackOptions ofrece un control de bajo nivel sobre las opciones de reproducción multimedia. Aunque recomendamos encarecidamente utilizar la configuración predeterminada de QMediaPlayer, QPlaybackOptions 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.

Ten en cuenta que las opciones son sugerencias para el backend multimedia y pueden ignorarse si no son compatibles con el formato multimedia o el códec actual.

Las opciones de reproducción dependen de la compatibilidad del backend multimedia. La disponibilidad se documenta para cada opción.

Véase también QMediaPlayer.

Documentación sobre los tipos de miembro

[since 6.10] enum class QPlaybackOptions::PlaybackIntent

Configura el objetivo de la reproducción multimedia, para centrarse bien en una reproducción de alta calidad, bien en la transmisión multimedia de baja latencia.

ConstanteValorDescripción
QPlaybackOptions::PlaybackIntent::Playback0El objetivo es una reproducción multimedia robusta y de alta calidad, lo que permite un almacenamiento en búfer suficiente para evitar fallos durante la reproducción.
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming1El almacenamiento en búfer se reduce para optimizar la transmisión con baja latencia, pero con una mayor probabilidad de pérdida de fotogramas u otros fallos durante la reproducción.

Esta enumeración se introdujo en Qt 6.10.

Documentación de la propiedad

[since 6.10] networkTimeout : std::chrono::milliseconds

Determina el tiempo de espera de red que se utiliza para las operaciones de E/S de sockets con determinados formatos de red.

Esta opción solo es compatible con el backend multimedia FFmpeg.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

std::chrono::milliseconds networkTimeout() const
void setNetworkTimeout(std::chrono::milliseconds timeout)
void resetNetworkTimeout()

[since 6.10] playbackIntent : PlaybackIntent

Determina si QMediaPlayer debe optimizarse para una reproducción de vídeo robusta y de alta calidad (opción predeterminada) o para una transmisión con baja latencia.

Esta opción solo es compatible con el backend multimedia FFmpeg.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

QPlaybackOptions::PlaybackIntent playbackIntent() const
void setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent)
void resetPlaybackIntent()

[since 6.10] probeSize : qsizetype

El parámetro «probesize» define la cantidad de datos (en bytes) que se van a analizar para recopilar información sobre la transmisión antes de que comience la reproducción del contenido multimedia.

Un valor más alto de «probesize» puede proporcionar una reproducción más estable, pero puede aumentar la latencia. Por el contrario, un valor más bajo de «probesize» puede reducir la latencia, pero podría omitir algunos detalles de la transmisión. El valor predeterminado de «probesize» es -1, y el valor real lo determina el backend multimedia.

Esta opción solo es compatible con el backend multimedia de FFmpeg.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

qsizetype probeSize() const
void setProbeSize(qsizetype probeSizeBytes)
void resetProbeSize()

Documentación de las funciones miembro

[constexpr noexcept default] QPlaybackOptions::QPlaybackOptions(QPlaybackOptions &&)

Crea una instancia de ` QPlaybackOptions`.

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