QMediaPlaylist Class

 playlist = new QMediaPlaylist;
 playlist->addMedia(QUrl("http://example.com/movie1.mp4"));
 playlist->addMedia(QUrl("http://example.com/movie2.mp4"));
 playlist->addMedia(QUrl("http://example.com/movie3.mp4"));
 playlist->setCurrentIndex(1);

 player = new QMediaPlayer;
 player->setPlaylist(playlist);

 videoWidget = new QVideoWidget;
 player->setVideoOutput(videoWidget);
 videoWidget->show();

 player->play();

Member Function Documentation

QMediaPlaylist::QMediaPlaylist(QObject * parent = 0)

Create a new playlist object for with the given parent.

QMediaPlaylist::~QMediaPlaylist() [virtual]

Destroys the playlist.

bool QMediaPlaylist::addMedia(const QMediaContent & content)

Append the media content to the playlist.

Returns true if the operation is successful, otherwise return false.

bool QMediaPlaylist::addMedia(const QList<QMediaContent> & items)

Append multiple media content items to the playlist.

Returns true if the operation is successful, otherwise return false.

bool QMediaPlaylist::clear()

Remove all the items from the playlist.

Returns true if the operation is successful, otherwise return false.

Error QMediaPlaylist::error() const

Returns the last error condition.

QString QMediaPlaylist::errorString() const

Returns the string describing the last error condition.

bool QMediaPlaylist::insertMedia(int pos, const QMediaContent & content)

Insert the media content to the playlist at position pos.

Returns true if the operation is successful, otherwise false.

bool QMediaPlaylist::insertMedia(int pos, const QList<QMediaContent> & items)

Insert multiple media content items to the playlist at position pos.

Returns true if the operation is successful, otherwise false.

bool QMediaPlaylist::isEmpty() const

Returns true if the playlist contains no items; otherwise returns false.

See also mediaCount().

bool QMediaPlaylist::isReadOnly() const

Returns true if the playlist can be modified; otherwise returns false.

See also mediaCount().

void QMediaPlaylist::load(const QNetworkRequest & request, const char * format = 0)

Load playlist using network request. If format is specified, it is used, otherwise format is guessed from playlist name and data.

New items are appended to playlist.

QMediaPlaylist::loaded() signal is emitted if playlist was loaded successfully, otherwise the playlist emits loadFailed().

void QMediaPlaylist::load(const QUrl & location, const char * format = 0)

Load playlist from location. If format is specified, it is used, otherwise format is guessed from location name and data.

New items are appended to playlist.

QMediaPlaylist::loaded() signal is emitted if playlist was loaded successfully, otherwise the playlist emits loadFailed().

void QMediaPlaylist::load(QIODevice * device, const char * format = 0)

Load playlist from QIODevice device. If format is specified, it is used, otherwise format is guessed from device data.

New items are appended to playlist.

QMediaPlaylist::loaded() signal is emitted if playlist was loaded successfully, otherwise the playlist emits loadFailed().

void QMediaPlaylist::loadFailed() [signal]

Signal emitted if failed to load playlist.

void QMediaPlaylist::loaded() [signal]

Signal emitted when playlist finished loading.

QMediaContent QMediaPlaylist::media(int index) const

Returns the media content at index in the playlist.

void QMediaPlaylist::mediaAboutToBeInserted(int start, int end) [signal]

Signal emitted when items are to be inserted at start and ending at end.

void QMediaPlaylist::mediaAboutToBeRemoved(int start, int end) [signal]

Signal emitted when item are to be deleted at start and ending at end.

void QMediaPlaylist::mediaChanged(int start, int end) [signal]

This signal is emitted after media has been changed in the playlist between start and end positions inclusive.

int QMediaPlaylist::mediaCount() const

Returns the number of items in the playlist.

See also isEmpty().

void QMediaPlaylist::mediaInserted(int start, int end) [signal]

This signal is emitted after media has been inserted into the playlist. The new items are those between start and end inclusive.

QMediaObject * QMediaPlaylist::mediaObject() const [virtual]

Reimplemented from QMediaBindableInterface::mediaObject().

Returns the QMediaObject instance that this QMediaPlaylist is bound too, or 0 otherwise.

void QMediaPlaylist::mediaRemoved(int start, int end) [signal]

This signal is emitted after media has been removed from the playlist. The removed items are those between start and end inclusive.

void QMediaPlaylist::next() [slot]

Advance to the next media content in playlist.

int QMediaPlaylist::nextIndex(int steps = 1) const

Returns the index of the item, which would be current after calling next() steps times.

Returned value depends on the size of playlist, current position and playback mode.

See also QMediaPlaylist::playbackMode.

void QMediaPlaylist::previous() [slot]

Return to the previous media content in playlist.

int QMediaPlaylist::previousIndex(int steps = 1) const

Returns the index of the item, which would be current after calling previous() steps times.

See also QMediaPlaylist::playbackMode.

bool QMediaPlaylist::removeMedia(int pos)

Remove the item from the playlist at position pos.

Returns true if the operation is successful, otherwise return false.

bool QMediaPlaylist::removeMedia(int start, int end)

Remove items in the playlist from start to end inclusive.

Returns true if the operation is successful, otherwise return false.

bool QMediaPlaylist::save(const QUrl & location, const char * format = 0)

Save playlist to location. If format is specified, it is used, otherwise format is guessed from location name.

Returns true if playlist was saved successfully, otherwise returns false.

bool QMediaPlaylist::save(QIODevice * device, const char * format)

Save playlist to QIODevice device using format format.

Returns true if playlist was saved successfully, otherwise returns false.

void QMediaPlaylist::shuffle() [slot]

Shuffle items in the playlist.