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
公開関数
| 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) |
詳細な説明
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 は、メディアの再生が開始される前にストリーム情報を収集するために分析するデータ量(バイト単位)を定義します。
probesize の値を大きくすると、再生の安定性は高まりますが、レイテンシが増加する可能性があります。逆に、probesize の値を小さくするとレイテンシは低減されますが、ストリームの詳細情報が一部取得できない場合があります。デフォルトの probesize は -1 であり、実際の probesize はメディアバックエンドによって決定されます。
このオプションは、FFmpeg メディアバックエンドでのみサポートされています。
この列挙型はQt 6.10で導入されました。
アクセス関数:
| qsizetype | probeSize() const |
| void | setProbeSize(qsizetype probeSizeBytes) |
| void | resetProbeSize() |
メンバ関数のドキュメント
[constexpr noexcept default] QPlaybackOptions::QPlaybackOptions(QPlaybackOptions &&)
QPlaybackOptions のインスタンスを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.