QPlaybackOptions Class
La clase QPlaybackOptions permite el control de bajo nivel de las opciones de reproducción multimedia. Más...
| Cabecera: | #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
(since 6.10)networkTimeout : std::chrono::milliseconds(since 6.10)playbackIntent : PlaybackIntent(since 6.10)probeSize : qsizetype
Funciones públicas
| 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 proporciona un control de bajo nivel de las opciones de reproducción multimedia. Aunque recomendamos encarecidamente confiar en la configuración predeterminada de QMediaPlayer, QPlaybackOptions se puede utilizar para optimizar la reproducción multimedia para casos de uso específicos en los que las opciones predeterminadas no son ideales.
Ten en cuenta que las opciones son sugerencias para el backend multimedia y pueden ser ignoradas si no son compatibles con el formato multimedia o códec actual.
Las opciones de reproducción dependen de la compatibilidad con el backend multimedia. La disponibilidad se documenta por opción.
Véase también QMediaPlayer.
Documentación de los tipos de miembros
[since 6.10] enum class QPlaybackOptions::PlaybackIntent
Configura la intención de la reproducción multimedia, para centrarse en la reproducción de alta calidad o en la transmisión multimedia de baja latencia.
| Constante | Valor | Descripción |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | La intención es una reproducción multimedia robusta y de alta calidad, permitiendo un almacenamiento en búfer suficiente para evitar fallos durante la reproducción. |
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming | 1 | El almacenamiento en búfer se reduce para optimizar la transmisión de baja latencia, pero con una mayor probabilidad de pérdida de fotogramas u otros fallos durante la reproducción. |
Este enum se introdujo en Qt 6.10.
Documentación de Propiedades
[since 6.10] networkTimeout : std::chrono::milliseconds
Determina el tiempo de espera de red utilizado para las operaciones de E/S de socket con algunos formatos de red.
Esta opción sólo es compatible con el backend multimedia FFmpeg.
Esta propiedad 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 (por defecto), o para un streaming de baja latencia.
Esta opción sólo es compatible con el backend multimedia FFmpeg.
Esta propiedad 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
Probesize define la cantidad de datos (en bytes) a analizar para recopilar información del flujo antes de que comience la reproducción multimedia.
Un valor de tamaño de sondeo mayor puede proporcionar una reproducción más sólida, pero puede aumentar la latencia. A la inversa, un valor menor puede reducir la latencia, pero puede pasar por alto algunos detalles del flujo. El valor predeterminado es -1, y el valor real lo determina el servidor multimedia.
Esta opción sólo es compatible con el backend FFmpeg.
Esta propiedad se introdujo en Qt 6.10.
Funciones de acceso:
| qsizetype | probeSize() const |
| void | setProbeSize(qsizetype probeSizeBytes) |
| void | resetProbeSize() |
© 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.
