PlaybackOptions QML Type
Options de lecture multimédia de bas niveau. En savoir plus…
| 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 offrent un contrôle approfondi des paramètres de lecture multimédia. Bien que nous recommandions vivement de s'en tenir aux paramètres par défaut de MediaPlayer, PlaybackOptions 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 ces 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. Leur disponibilité est indiquée pour chaque option.
Voir également MediaPlayer.
Documentation des propriétés
networkTimeoutMs : qint64 [since 6.10]
Définit le délai d'expiration réseau (en millisecondes) 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 multimédia FFmpeg.
Cette propriété a été introduite dans Qt 6.10.
playbackIntent : enumeration [since 6.10]
Détermine si MediaPlayer 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.
| Constante | Description |
|---|---|
PlaybackOptions.Playback | L'objectif est d'assurer une lecture multimédia robuste et de haute qualité, en permettant une mise en mémoire tampon suffisante pour éviter les saccades pendant la lecture. |
PlaybackOptions.LowLatencyStreaming | La mise en mémoire tampon est réduite pour optimiser le streaming à faible latence, mais avec un risque accru de perte d’images ou d’autres perturbations pendant la lecture. |
Cette propriété a été introduite dans Qt 6.10.
probeSize : qsizetype [since 6.10]
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 passer à côté de certains détails du flux. La valeur par défaut de `probesize` est -1 ; la valeur réelle est alors déterminée par le backend multimédia.
Notez qu’une taille de sondage trop faible peut entraîner un échec de la lecture du média, tandis qu’une taille de sondage trop élevée peut augmenter la latence.
Cette option n’est prise en charge qu’avec le backend multimé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.