このページでは

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 }

プロパティ

公開関数

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::Playback0このインテントは、堅牢かつ高品質なメディア再生を目的としており、再生中の不具合を防ぐために十分なバッファリングを可能にします。
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming1バッファリングを削減して低遅延ストリーミングに最適化されますが、再生中にフレームが失われたり、その他の不具合が発生する可能性が高くなります。

この列挙型は 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.