PlaybackOptions QML Type
Options de lecture de médias de bas niveau. Plus d'informations...
| Import Statement: | import QtMultimedia |
| Since: | Qt 6.10 |
| In C++: | QPlaybackOptions |
Propriétés
- networkTimeoutMs : qint64
(since 6.10) - playbackIntent : enumeration
(since 6.10) - probeSize : qsizetype
(since 6.10)
Description détaillée
Les options de lecture permettent un contrôle de bas niveau des options de lecture des médias. Bien qu'il soit fortement recommandé de se fier aux paramètres par défaut de MediaPlayer, les options de lecture peuvent être utilisées 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 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 aussi MediaPlayer.
Documentation sur les propriétés
networkTimeoutMs : qint64 [since 6.10]
Détermine le délai d'attente réseau (en millisecondes) utilisé pour les opérations d'E/S sur les sockets avec certains formats réseau.
Cette option n'est supportée qu'avec le backend média FFmpeg.
Cette propriété a été introduite dans Qt 6.10.
playbackIntent : enumeration [since 6.10]
Détermine si MediaPlayer 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 supportée qu'avec le backend média FFmpeg.
| Constante | Description |
|---|---|
PlaybackOptions.Playback | L'objectif est une lecture robuste et de haute qualité, permettant une mise en mémoire tampon suffisante pour éviter les problèmes de lecture. |
PlaybackOptions.LowLatencyStreaming | 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 propriété a été introduite dans Qt 6.10.
probeSize : qsizetype [since 6.10]
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 est -1, et la valeur réelle est déterminée par le backend du média.
Notez qu'un probeSize trop petit peut entraîner l'échec de la lecture du média, tandis qu'un probeSize trop grand peut augmenter la 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.
© 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.
