QPlaybackOptions Class
Die Klasse „QPlaybackOptions“ ermöglicht eine detaillierte Steuerung der Optionen für die Medienwiedergabe. Mehr...
| Header: | #include <QPlaybackOptions> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Seit: | Qt 6.10 |
| In QML: | PlaybackOptions |
Öffentliche Typen
(since 6.10) enum class | PlaybackIntent { Playback, LowLatencyStreaming } |
Eigenschaften
(since 6.10)networkTimeout : std::chrono::milliseconds(since 6.10)playbackIntent : PlaybackIntent(since 6.10)probeSize : qsizetype
Öffentliche Funktionen
| 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) |
Ausführliche Beschreibung
QPlaybackOptions ermöglicht die Steuerung der Medienwiedergabeoptionen auf niedriger Ebene. Obwohl wir dringend empfehlen, sich auf die Standardeinstellungen von QMediaPlayer zu verlassen, kann QPlaybackOptions verwendet werden, um die Medienwiedergabe für bestimmte Anwendungsfälle zu optimieren, in denen die Standardoptionen nicht ideal sind.
Beachten Sie, dass Optionen lediglich Hinweise für das Medien-Backend darstellen und möglicherweise ignoriert werden, wenn sie vom aktuellen Medienformat oder Codec nicht unterstützt werden.
Die Wiedergabeoptionen sind von der Unterstützung durch das Medien-Backend abhängig. Die Verfügbarkeit ist für jede Option dokumentiert.
Siehe auch QMediaPlayer.
Dokumentation zum Mitgliedstyp
[since 6.10] enum class QPlaybackOptions::PlaybackIntent
Konfiguriert den Zweck der Medienwiedergabe, um den Schwerpunkt entweder auf eine hochwertige Wiedergabe oder auf Medien-Streaming mit geringer Latenz zu legen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | Der Zweck ist eine robuste und qualitativ hochwertige Medienwiedergabe, die eine ausreichende Pufferung ermöglicht, um Störungen während der Wiedergabe zu verhindern. |
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming | 1 | Die Pufferung wird reduziert, um das Streaming mit geringer Latenz zu optimieren, wobei jedoch eine höhere Wahrscheinlichkeit für verlorene Frames oder andere Störungen während der Wiedergabe besteht. |
Diese Enumeration wurde in Qt 6.10 eingeführt.
Eigenschaftsdokumentation
[since 6.10] networkTimeout : std::chrono::milliseconds
Legt das Netzwerk-Timeout fest, das für Socket-E/A-Vorgänge mit bestimmten Netzwerkformaten verwendet wird.
Diese Option wird nur vom FFmpeg-Medien-Backend unterstützt.
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| std::chrono::milliseconds | networkTimeout() const |
| void | setNetworkTimeout(std::chrono::milliseconds timeout) |
| void | resetNetworkTimeout() |
[since 6.10] playbackIntent : PlaybackIntent
Legt fest, ob „ QMediaPlayer “ die Wiedergabe von Videos mit hoher Qualität und hoher Robustheit (Standard) oder das Streaming mit geringer Latenz optimieren soll.
Diese Option wird nur mit dem FFmpeg-Medien-Backend unterstützt.
Diese Enumeration wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| QPlaybackOptions::PlaybackIntent | playbackIntent() const |
| void | setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent) |
| void | resetPlaybackIntent() |
[since 6.10] probeSize : qsizetype
Die „Probesize“ legt die Datenmenge (in Byte) fest, die analysiert werden soll, um Stream-Informationen zu erfassen, bevor die Medienwiedergabe beginnt.
Ein größerer „probesize“-Wert kann zu einer stabileren Wiedergabe führen, erhöht jedoch möglicherweise die Latenz. Umgekehrt kann ein kleinerer „probesize“-Wert die Latenz verringern, führt jedoch möglicherweise dazu, dass einige Stream-Details übersehen werden. Der Standardwert für „probesize“ ist -1, und die tatsächliche Größe wird vom Medien-Backend festgelegt.
Diese Option wird nur vom FFmpeg-Medien-Backend unterstützt.
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| qsizetype | probeSize() const |
| void | setProbeSize(qsizetype probeSizeBytes) |
| void | resetProbeSize() |
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept default] QPlaybackOptions::QPlaybackOptions(QPlaybackOptions &&)
Erstellt eine Instanz von ` QPlaybackOptions` mithilfe von `Move`.
© 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.
