PlaybackOptions QML Type
低レベルのメディア再生オプション。詳細...
| Import Statement: | import QtMultimedia |
| Since: | Qt 6.10 |
| In C++: | QPlaybackOptions |
プロパティ
- networkTimeoutMs : qint64
(since 6.10) - playbackIntent : enumeration
(since 6.10) - probeSize : qsizetype
(since 6.10)
詳細説明
PlaybackOptions を使用すると、メディア再生オプションを低レベルで制御できます。MediaPlayer のデフォルト設定を利用することを強く推奨しますが、デフォルトの設定では不適切な特定のユースケースにおいて、PlaybackOptions を使用してメディア再生を最適化することができます。
なお、オプションはメディアバックエンドへのヒントであり、現在のメディア形式やコーデックでサポートされていない場合は無視される可能性があります。
再生オプションは、メディアバックエンドでのサポートに依存します。利用可能性については、各オプションごとに文書化されています。
MediaPlayerも参照してください 。
プロパティのドキュメント
networkTimeoutMs : qint64 [since 6.10]
一部のネットワークフォーマットでのソケットI/O操作に使用されるネットワークタイムアウト(ミリ秒単位)を指定します。
このオプションは、FFmpeg メディアバックエンドでのみサポートされています。
このプロパティは Qt 6.10 で導入されました。
playbackIntent : enumeration [since 6.10]
MediaPlayer が、堅牢で高品質な動画再生(デフォルト)を優先するか、低遅延のストリーミングを優先するかを決定します。
このオプションは、FFmpeg メディアバックエンドでのみサポートされています。
| 定数 | 説明 |
|---|---|
PlaybackOptions.Playback | 堅牢で高品質なメディア再生を目的としており、再生中の不具合を防ぐために十分なバッファリングが行われます。 |
PlaybackOptions.LowLatencyStreaming | バッファリングは低遅延ストリーミングに最適化されるため削減されますが、再生中のフレームロスやその他の不具合が発生する可能性が高くなります。 |
このプロパティは Qt 6.10 で導入されました。
probeSize : qsizetype [since 6.10]
probesize は、メディアの再生が開始される前にストリーム情報を収集するために分析するデータ量(バイト単位)を指定します。
probesizeの値を大きくすると、再生の安定性は向上しますが、レイテンシが増加する可能性があります。逆に、probesizeの値を小さくするとレイテンシは低減されますが、ストリームの詳細情報が一部取得できない場合があります。probesizeのデフォルト値は-1であり、実際のprobesizeはメディアバックエンドによって決定されます。
probesizeの値が小さすぎるとメディアの再生に失敗する可能性があり、逆に大きすぎるとレイテンシが増加する可能性があることに注意してください。
このオプションは、FFmpeg メディアバックエンドでのみサポートされています。
このプロパティは Qt 6.10 で導入されました。
© 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.