QMediaPlayer Class

 player = new QMediaPlayer;
 audioOutput = new QAudioOutput;
 player->setAudioOutput(audioOutput);
 connect(player, SIGNAL(positionChanged(qint64)), this, SLOT(positionChanged(qint64)));
 player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
 audioOutput->setVolume(50);
 player->play();

Member Function Documentation

QMediaPlayer::QMediaPlayer(QObject *parent = nullptr)

Constructs a QMediaPlayer instance as a child of parent.

[signal] void QMediaPlayer::bufferProgressChanged(float filled)

Signals the amount of the local buffer filled as a number between 0 and 1.

Note: Notifier signal for property bufferProgress.

[signal] void QMediaPlayer::durationChanged(qint64 duration)

Signals the duration of the content has changed to duration, expressed in milliseconds.

Note: Notifier signal for property duration.

[signal] void QMediaPlayer::errorOccurred(QMediaPlayer::Error error, const QString &errorString)

Signals that an error condition has occurred, with errorString containing a description of the error.

See also errorString().

[signal] void QMediaPlayer::hasAudioChanged(bool available)

Signals the availability of audio content has changed to available.

Note: Notifier signal for property hasAudio.

[signal] void QMediaPlayer::hasVideoChanged(bool videoAvailable)

Signals the availability of visual content has changed to videoAvailable.

Note: Notifier signal for property hasVideo.

[signal] void QMediaPlayer::mediaStatusChanged(QMediaPlayer::MediaStatus status)

Signals that the status of the current media has changed.

Note: Notifier signal for property mediaStatus.

See also mediaStatus().

[slot] void QMediaPlayer::pause()

Pause playing the current source.

See also play() and stop().

[slot] void QMediaPlayer::play()

Start or resume playing the current source.

See also pause() and stop().

[signal] void QMediaPlayer::playbackRateChanged(qreal rate)

Signals the playbackRate has changed to rate.

Note: Notifier signal for property playbackRate.

[signal] void QMediaPlayer::positionChanged(qint64 position)

Signals the position of the content has changed to position, expressed in milliseconds.

Note: Notifier signal for property position.

[signal] void QMediaPlayer::seekableChanged(bool seekable)

Signals the seekable status of the player object has changed.

Note: Notifier signal for property seekable.

[slot] void QMediaPlayer::setSource(const QUrl &source)

Sets the current source.

Setting the media to a null QUrl will cause the player to discard all information relating to the current media source and to cease all I/O operations related to that media.

Note: This function returns immediately after recording the specified source of the media. It does not wait for the media to finish loading and does not check for errors. Listen for the mediaStatusChanged() and error() signals to be notified when the media is loaded and when an error occurs during loading.

Note: Setter function for property source.

See also source().

[slot] void QMediaPlayer::setSourceDevice(QIODevice *device, const QUrl &sourceUrl = QUrl())

Sets the current source device.

The media data will be read from device. The sourceUrl can be provided to resolve additional information about the media, mime type etc. The device must be open and readable.

For macOS the device should also be seek-able.

Note: This function returns immediately after recording the specified source of the media. It does not wait for the media to finish loading and does not check for errors. Listen for the mediaStatusChanged() and error() signals to be notified when the media is loaded, and if an error occurs during loading.

See also sourceDevice().

[signal] void QMediaPlayer::sourceChanged(const QUrl &media)

Signals that the media source has been changed to media.

Note: Notifier signal for property source.

[slot] void QMediaPlayer::stop()

Stop playing, and reset the play position to the beginning.

See also play() and pause().

[virtual] QMediaPlayer::~QMediaPlayer()

Destroys the player object.

QList<QMediaMetaData> QMediaPlayer::audioTracks() const

Lists the set of available audio tracks inside the media.

The QMediaMetaData returned describes the properties of individual tracks.

Different audio tracks can for example contain audio in different languages.

Note: Getter function for property audioTracks.

float QMediaPlayer::bufferProgress() const

Returns a number betwee 0 and 1 when buffering data.

0 means that there is no buffered data available, playback is usually stalled in this case. Playback will resume once the buffer reaches 1, meaning enough data has been buffered to be able to resume playback.

bufferProgress() will always return 1 for local files.

Note: Getter function for property bufferProgress.

QMediaTimeRange QMediaPlayer::bufferedTimeRange() const

Returns a QMediaTimeRange describing the currently buffered data.

When streaming media from a remote source, different parts of the media file can be available locally. The returned QMediaTimeRange object describes the time ranges that are buffered and available for immediate playback.

See also QMediaTimeRange.

qint64 QMediaPlayer::duration() const

Returns the duration of the current media in ms.

Returns 0 if the media player doesn't have a valid media file or stream. For live streams, the duration usually changes during playback as more data becomes available.

Note: Getter function for property duration.

QMediaPlayer::Error QMediaPlayer::error() const

Returns the current error state.

Note: Getter function for property error.

bool QMediaPlayer::isAvailable() const

Returns true if the media player is supported on this platform.

bool QMediaPlayer::isSeekable() const

Returns true if the media is seekable. Most file based media files are seekable, but live streams usually are not.

Note: Getter function for property seekable.

See also position.

QMediaMetaData QMediaPlayer::metaData() const

Returns meta data for the current media used by the media player.

Meta data can contain information such as the title of the video or its creation date.

Note: The Windows implementation provides metadata only for media located on the local file system.

Note: Getter function for property metaData.

qreal QMediaPlayer::playbackRate() const

Returns the current playback rate.

Note: Getter function for property playbackRate.

See also setPlaybackRate().

qint64 QMediaPlayer::position() const

Returns the current position inside the media being played back in ms.

Returns 0 if the media player doesn't have a valid media file or stream. For live streams, the duration usually changes during playback as more data becomes available.

Note: Getter function for property position.

See also setPosition().

const QIODevice *QMediaPlayer::sourceDevice() const

Returns the stream source of media data.

This is only valid if a stream was passed to setSource().

See also setSourceDevice() and setSource().

QList<QMediaMetaData> QMediaPlayer::subtitleTracks() const

Lists the set of available subtitle tracks inside the media.

The QMediaMetaData returned describes the properties of individual tracks.

Note: Getter function for property subtitleTracks.

QList<QMediaMetaData> QMediaPlayer::videoTracks() const

Lists the set of available video tracks inside the media.

The QMediaMetaData returned describes the properties of individual tracks.

Note: Getter function for property videoTracks.