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
(since 6.10)networkTimeout : std::chrono::milliseconds(since 6.10)playbackIntent : PlaybackIntent(since 6.10)probeSize : qsizetype
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.
| Constante | Valor | Descripción |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | El 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::LowLatencyStreaming | 1 | El 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.