QMediaGaplessPlaybackControl Class | Qt Multimedia 5.9

Qt 5.9 | Qt Multimedia | C++ Classes | QMediaGaplessPlaybackControl

Qt 5.9.2 Reference Documentation

# QMediaGaplessPlaybackControl Class

The QMediaGaplessPlaybackControl class provides access to the gapless playback related control of a QMediaService. More...

Header: | #include <QMediaGaplessPlaybackControl>
qmake: | QT += multimedia
Inherits: | QMediaControl

- List of all members, including inherited members

## Public Functions

virtual | ~QMediaGaplessPlaybackControl()
virtual qreal | crossfadeTime() const = 0
virtual bool | isCrossfadeSupported() const = 0
virtual QMediaContent | nextMedia() const = 0
virtual void | setCrossfadeTime(qreal crossfadeTime) = 0
virtual void | setNextMedia(const QMediaContent &media) = 0

## Signals

void | advancedToNextMedia()
void | crossfadeTimeChanged(qreal crossfadeTime)
void | nextMediaChanged(const QMediaContent &media)

## Protected Functions

| QMediaGaplessPlaybackControl(QObject *parent = Q_NULLPTR)

## Macros

| QMediaGaplessPlaybackControl_iid

## Detailed Description

The QMediaGaplessPlaybackControl class provides access to the gapless playback related control of a QMediaService.

If a QMediaService supports gapless playback it will implement QMediaGaplessPlaybackControl. This control provides a means to set the next media or crossfade time for smooth transitions between tracks.

The functionality provided by this control is exposed to application code through the QMediaPlayer class.

The interface name of QMediaGaplessPlaybackControl is `org.qt-project.qt.mediagaplessplaybackcontrol/5.0` as defined in QMediaGaplessPlaybackControl_iid.

See also QMediaService::requestControl() and QMediaPlayer.

## Member Function Documentation

### `[protected]` QMediaGaplessPlaybackControl::QMediaGaplessPlaybackControl(QObject *parent = Q_NULLPTR)

Constructs a new gapless playback control with the given parent.

### `[virtual]` QMediaGaplessPlaybackControl::~QMediaGaplessPlaybackControl()

Destroys a gapless playback control.

### `[signal]` void QMediaGaplessPlaybackControl::advancedToNextMedia()

Signals when the player advances to the next media (the content of next media will be cleared).

See also nextMedia().

### `[pure virtual]` qreal QMediaGaplessPlaybackControl::crossfadeTime() const

Returns current crossfade time in seconds.

See also setCrossfadeTime().

### `[signal]` void QMediaGaplessPlaybackControl::crossfadeTimeChanged(qreal crossfadeTime)

Signals that the crossfadeTime has changed.

See also crossfadeTime().

### `[pure virtual]` bool QMediaGaplessPlaybackControl::isCrossfadeSupported() const

Indicates whether crossfading is supported or not. If crossfading is not supported, setCrossfadeTime() will be ignored and crossfadeTime() will always return 0.

### `[pure virtual]` QMediaContent QMediaGaplessPlaybackControl::nextMedia() const

Returns the content of the next media

See also setNextMedia().

### `[signal]` void QMediaGaplessPlaybackControl::nextMediaChanged(const QMediaContent &media)

Signals that the next media has changed (either explicitly via setNextMedia() or when the player clears the next media while advancing to it).

See also nextMedia().

### `[pure virtual]` void QMediaGaplessPlaybackControl::setCrossfadeTime(qreal crossfadeTime)

Sets the crossfadeTime in seconds for smooth transition.

Positive value means how much time it will take for the next media to transit from silent to full volume and vice versa for current one. So both current and the next one will be playing during this period of time.

A crossfade time of zero or negative will result in gapless playback (suitable for some continuous media).

See also crossfadeTime().

### `[pure virtual]` void QMediaGaplessPlaybackControl::setNextMedia(const QMediaContent &media)

Sets the next media for smooth transition.

See also nextMedia().

## Macro Documentation

### QMediaGaplessPlaybackControl_iid

`org.qt-project.qt.mediagaplessplaybackcontrol/5.0`

Defines the interface name of the QMediaGaplessPlaybackControl class.