PlaybackOptions QML Type | Qt Multimedia | Qt 6.12.0
Description: Low level media playback options.
Keywords: qmltype

- Qt 6.12
- Qt Multimedia
- QML Types
- PlaybackOptions
- Qt 6.12.0 Reference Documentation

# PlaybackOptions QML Type

Low level media playback options. More...

Import Statement: | `import QtMultimedia`
Since: | Qt 6.10
In C++: | QPlaybackOptions

- List of all members, including inherited members

## Properties

- networkTimeoutMs : qint64 `(since 6.10)`
- playbackIntent : enumeration `(since 6.10)`
- probeSize : qsizetype `(since 6.10)`

## Detailed Description

Playback options gives low-level control of media playback options. Although we strongly recommend to rely on the default settings of MediaPlayer, PlaybackOptions can be used to optimize media playback to specific use cases where the default options are not ideal.

Note that options are hints to the media backend, and may be ignored if they are not supported by the current media format or codec.

Playback options rely on support in the media backend. Availability is documented per option.

See also MediaPlayer.

## Property Documentation

### networkTimeoutMs : qint64 `[since 6.10]`

Determines the network timeout (in milliseconds) used for socket I/O operations with some network formats.

This option is only supported with the FFmpeg media backend.

This property was introduced in Qt 6.10.

### playbackIntent : enumeration `[since 6.10]`

Determines if MediaPlayer should optimize for robust high quality video playback (default), or low latency streaming.

This option is only supported with the FFmpeg media backend.

Constant | Description
--- | ---
`PlaybackOptions.Playback` | The intent is robust and high quality media playback, enabling sufficient buffering to prevent glitches during playback.
`PlaybackOptions.LowLatencyStreaming` | Buffering is reduced to optimize for low latency streaming, but with a higher likelihood of lost frames or other glitches during playback.

This property was introduced in Qt 6.10.

### probeSize : qsizetype `[since 6.10]`

Probesize defines the amount of data (in bytes) to analyze in order to gather stream information before media playback starts.

A larger probesize value can give more robust playback but may increase latency. Conversely, a smaller probesize can reduce latency but might miss some stream details. The default probesize is -1, and the actual probesize is then determined by the media backend.

Note that a too small probeSize can result in failure to play the media, while a too high probeSize can increase latency.

This option is only supported with the FFmpeg media backend.

This property was introduced in Qt 6.10.