QPlaybackOptions Class
La classe `QPlaybackOptions` permet un contrôle de bas niveau des options de lecture multimédia. En savoir plus...
| 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
| 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) |
Description détaillée
QPlaybackOptions offre un contrôle de bas niveau sur les options de lecture multimédia. Bien que nous recommandions vivement de s'en tenir aux paramètres par défaut de QMediaPlayer, QPlaybackOptions peut être utilisé pour optimiser la lecture multimédia dans des cas d'utilisation spécifiques où les options par défaut ne sont pas idéales.
Notez que les options constituent des indications destinées au moteur multimédia et peuvent être ignorées si elles ne sont pas prises en charge par le format multimédia ou le codec utilisé.
Les options de lecture dépendent de la prise en charge par le moteur multimédia. La disponibilité est indiquée pour chaque option.
Voir également QMediaPlayer.
Documentation sur les types de membres
[since 6.10] enum class QPlaybackOptions::PlaybackIntent
Permet de définir l'objectif de la lecture multimédia, en privilégiant soit une lecture de haute qualité, soit une diffusion multimédia à faible latence.
| Constante | Valeur | Description |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | L'objectif est une lecture multimédia robuste et de haute qualité, permettant une mise en mémoire tampon suffisante pour éviter les ratés 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 un risque accru de perte d’images ou d’autres problèmes techniques pendant la lecture. |
Cette énumération a été introduite dans Qt 6.10.
Documentation de la propriété
[since 6.10] networkTimeout : std::chrono::milliseconds
Définit le délai d'expiration réseau utilisé pour les opérations d'E/S sur sockets avec certains formats réseau.
Cette option n'est prise en charge qu'avec le backend multimédia FFmpeg.
Cette énumération 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 privilégier une lecture vidéo robuste et de haute qualité (par défaut) ou une diffusion en continu à faible latence.
Cette option n'est prise en charge qu'avec le backend multimédia FFmpeg.
Cette énumération 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
La valeur « probesize » définit la quantité de données (en octets) à analyser afin de recueillir des informations sur le flux avant le début de la lecture du média.
Une valeur de `probesize` plus élevée peut garantir une lecture plus stable, mais peut augmenter la latence. À l'inverse, une valeur de `probesize` plus faible peut réduire la latence, mais risque de ne pas prendre en compte 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 moteur multimédia.
Cette option n’est prise en charge qu’avec le backend multimédia FFmpeg.
Cette énumération a été introduite dans Qt 6.10.
Fonctions d'accès :
| qsizetype | probeSize() const |
| void | setProbeSize(qsizetype probeSizeBytes) |
| void | resetProbeSize() |
Documentation des fonctions membres
[constexpr noexcept default] QPlaybackOptions::QPlaybackOptions(QPlaybackOptions &&)
Crée par « move » une instance 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.
