QPlaybackOptions Class
QPlaybackOptionsクラスは、メディア再生オプションの低レベル制御を可能にします。詳細...
| ヘッダー | #include <QPlaybackOptions> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake： | QT += multimedia |
| 以来： | Qt 6.10 |
| QML では | playbackOptions |
パブリックな型
(since 6.10) enum class | PlaybackIntent { Playback, LowLatencyStreaming } |
プロパティ
(since 6.10)networkTimeout : std::chrono::milliseconds(since 6.10)playbackIntent : PlaybackIntent(since 6.10)probeSize : qsizetype
パブリック機能
| 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) |
詳細説明
QPlaybackOptions は、メディア再生オプションの低レベル制御を提供します。QMediaPlayer のデフォルト設定に依存することを強く推奨しますが、QPlaybackOptions を使用することで、デフォルトのオプションが理想的でない特定のユースケースに合わせてメディア再生を最適化することができます。
オプションはメディアバックエンドへのヒントであり、現在のメディアフォーマットやコーデックでサポートされていない場合は無視される可能性があることに注意してください。
再生オプションは、メディアバックエンドでのサポートに依存します。利用可能かどうかは、オプションごとに文書化されています。
QMediaPlayerも参照 。
メンバ型のドキュメント
[since 6.10] enum class QPlaybackOptions::PlaybackIntent
メディア再生の意図を設定し、高品質再生または低遅延メディアストリーミングのいずれかに焦点を当てる。
| 定数 | 値 | 説明 |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | ロバストで高品質なメディア再生を意図し、再生中のグリッチを防ぐために十分なバッファリングを可能にします。 |
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming | 1 | 低遅延ストリーミングに最適化するために、バッファリングは削減されますが、再生中に失われたフレームやその他のグリッチの可能性が高くなります。 |
この列挙型は Qt 6.10 で導入されました。
プロパティのドキュメント
[since 6.10] networkTimeout : std::chrono::milliseconds
いくつかのネットワークフォーマットでソケット I/O 操作に使用されるネットワークタイムアウトを決定します。
このオプションは、FFmpeg メディアバックエンドでのみサポートされています。
このプロパティは Qt 6.10 で導入されました。
アクセス関数：
| std::chrono::milliseconds | networkTimeout() const |
| void | setNetworkTimeout(std::chrono::milliseconds timeout) |
| void | resetNetworkTimeout() |
[since 6.10] playbackIntent : PlaybackIntent
QMediaPlayer を堅牢な高品質ビデオ再生（デフォルト）用に最適化するか、低遅延ストリーミング用に最適化するかを決定します。
このオプションは、FFmpeg メディアバックエンドでのみサポートされています。
このプロパティは Qt 6.10 で導入されました。
アクセス関数：
| QPlaybackOptions::PlaybackIntent | playbackIntent() const |
| void | setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent) |
| void | resetPlaybackIntent() |
[since 6.10] probeSize : qsizetype
Probesizeは、メディア再生開始前にストリーム情報を収集するために分析するデータ量（バイト単位）を定義する。
プローブサイズを大きくすると、よりロバストな再生が可能になるが、レイテンシが増加する可能性がある。逆に、プローブサイズを小さくすると、レイテンシは減るが、ストリームの詳細を見逃す可能性がある。デフォルトのプローブサイズは -1 で、実際のプローブサイズはメディアバックエンドが決定する。
このオプションは、FFmpeg メディアバックエンドでのみサポートされています。
このプロパティは Qt 6.10 で導入されました。
アクセス関数：
| 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.
