QPlaybackOptions Class
Die Klasse QPlaybackOptions ermöglicht die Steuerung von Medienwiedergabeoptionen auf niedriger Ebene. Mehr...
| Kopfzeile: | #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
| 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) |
Detaillierte Beschreibung
QPlaybackOptions ermöglicht die Steuerung von 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 Hinweise für das Medien-Backend sind und ignoriert werden können, wenn sie vom aktuellen Medienformat oder Codec nicht unterstützt werden.
Die Wiedergabeoptionen hängen von der Unterstützung durch das Medien-Backend ab. Die Verfügbarkeit ist für jede Option dokumentiert.
Siehe auch QMediaPlayer.
Dokumentation der Mitgliedstypen
[since 6.10] enum class QPlaybackOptions::PlaybackIntent
Konfiguriert die Absicht der Medienwiedergabe, um sich entweder auf eine qualitativ hochwertige Wiedergabe oder ein Medien-Streaming mit geringer Latenz zu konzentrieren.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | Die Absicht ist eine robuste und qualitativ hochwertige Medienwiedergabe, die eine ausreichende Pufferung ermöglicht, um Störungen während der Wiedergabe zu vermeiden. |
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming | 1 | Die Pufferung wird reduziert, um das Streaming mit niedriger Latenz zu optimieren, allerdings mit einer höheren Wahrscheinlichkeit von verlorenen Frames oder anderen Störungen während der Wiedergabe. |
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Dokumentation der Eigenschaft
[since 6.10] networkTimeout : std::chrono::milliseconds
Bestimmt das Netzwerk-Timeout, das für Socket-E/A-Operationen bei einigen Netzwerkformaten verwendet wird.
Diese Option wird nur mit dem FFmpeg Media Backend unterstützt.
Diese Eigenschaft 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 für eine stabile Videowiedergabe in hoher Qualität (Standard) oder für Streaming mit geringer Latenz optimiert werden soll.
Diese Option wird nur mit dem FFmpeg Media Backend unterstützt.
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| QPlaybackOptions::PlaybackIntent | playbackIntent() const |
| void | setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent) |
| void | resetPlaybackIntent() |
[since 6.10] probeSize : qsizetype
Probesize definiert die Datenmenge (in Bytes), die analysiert werden soll, um Stream-Informationen zu sammeln, bevor die Medienwiedergabe beginnt.
Ein größerer Probesize-Wert kann zu einer stabileren Wiedergabe führen, kann aber die Latenz erhöhen. Umgekehrt kann ein kleinerer Wert für probesize die Latenz verringern, aber möglicherweise einige Stream-Details übersehen. Die Standard-Probesize ist -1, und die tatsächliche Probesize wird vom Medien-Backend bestimmt.
Diese Option wird nur mit dem FFmpeg Media-Backend unterstützt.
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| qsizetype | probeSize() const |
| void | setProbeSize(qsizetype probeSizeBytes) |
| void | resetProbeSize() |
© 2025 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.
