QPlaybackOptions Class
La classe QPlaybackOptions permet un contrôle de bas niveau des options de lecture des médias. Plus d'informations...
| En-tête : | #include <QPlaybackOptions> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake : | QT += multimedia |
| Depuis : | Qt 6.10 |
| En QML : | PlaybackOptions |
Types publics
(since 6.10) enum class | PlaybackIntent { Playback, LowLatencyStreaming } |
Propriétés
(since 6.10)networkTimeout : std::chrono::milliseconds(since 6.10)playbackIntent : PlaybackIntent(since 6.10)probeSize : qsizetype
Fonctions publiques
| 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) |
Description détaillée
QPlaybackOptions permet un contrôle de bas niveau des options de lecture des médias. Bien que nous recommandions fortement de se fier aux paramètres par défaut de QMediaPlayer, QPlaybackOptions peut être utilisé pour optimiser la lecture des médias dans des cas d'utilisation spécifiques où les options par défaut ne sont pas idéales.
Notez que les options sont des indications pour le backend du média et qu'elles peuvent être ignorées si elles ne sont pas prises en charge par le format ou le codec du média en cours.
Les options de lecture dépendent de la prise en charge par le backend du média. La disponibilité est documentée pour chaque option.
Voir également QMediaPlayer.
Documentation sur les types de membres
[since 6.10] enum class QPlaybackOptions::PlaybackIntent
Configure l'intention de la lecture des médias, pour se concentrer soit sur une lecture de haute qualité, soit sur un flux de médias à faible latence.
| Constante | Valeur | Description |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | L'objectif est une lecture robuste et de haute qualité, permettant une mise en mémoire tampon suffisante pour éviter les problèmes pendant la lecture. |
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming | 1 | La mise en mémoire tampon est réduite pour optimiser la diffusion en continu à faible latence, mais avec une probabilité plus élevée de perte d'images ou d'autres problèmes pendant la lecture. |
Cette liste a été introduite dans Qt 6.10.
Documentation de la propriété
[since 6.10] networkTimeout : std::chrono::milliseconds
Détermine le délai d'attente réseau utilisé pour les opérations d'E/S sur les sockets avec certains formats réseau.
Cette option n'est prise en charge qu'avec le backend média FFmpeg.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| std::chrono::milliseconds | networkTimeout() const |
| void | setNetworkTimeout(std::chrono::milliseconds timeout) |
| void | resetNetworkTimeout() |
[since 6.10] playbackIntent : PlaybackIntent
Détermine si QMediaPlayer doit être optimisé pour une lecture vidéo robuste et de haute qualité (par défaut), ou pour une diffusion en continu à faible latence.
Cette option n'est prise en charge qu'avec le backend média FFmpeg.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| QPlaybackOptions::PlaybackIntent | playbackIntent() const |
| void | setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent) |
| void | resetPlaybackIntent() |
[since 6.10] probeSize : qsizetype
Probesize définit la quantité de données (en octets) à analyser afin de recueillir des informations sur le flux avant que la lecture du média ne commence.
Une valeur de probesize plus élevée peut donner une lecture plus robuste mais peut augmenter la latence. À l'inverse, une valeur plus petite peut réduire la latence, mais risque d'omettre certains détails du flux. La valeur par défaut de probesize est -1, et la valeur réelle est déterminée par le backend du média.
Cette option n'est prise en charge qu'avec le backend média FFmpeg.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| 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.
