Класс QMediaPlaylist

Класс QMediaPlaylist предоставляет список медиа-контента для воспроизведения. Подробнее...

• Список всех членов, включая унаследованные

Публичные типы

Свойства

• currentIndex : int
• currentMedia : const QMediaContent
• playbackMode : QMediaPlaylist::РежимВоспроизведения

• 1 свойство унаследовано от QObject

Публичные функции

Переопределённые публичные функции

• 34 общедоступных функций унаследовано от QObject
• 1 общедоступная функция унаследовано от QMediaBindableInterface

Общедоступные слоты

• 1 общедоступный слот унаследовано от QObject

Сигналы

• 2 сигнала унаследовано от QObject

Дополнительные унаследованные члены

• 1 общедоступная переменная унаследовано от QObject
• 10 статических общедоступных членов унаследовано от QObject
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследовано от QMediaBindableInterface
• 2 защищенных переменных унаследовано от QObject

Подробное описание

Класс QMediaPlaylist предоставляет список медиа-контента для воспроизведения.

QMediaPlaylist предназначен для использования с другими медиа-объектами, такими как QMediaPlayer.

QMediaPlaylist позволяет получить доступ к внутренней функциональности плейлиста, если она доступна, в противном случае предоставляет локальную реализацию плейлиста в памяти.

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();

В зависимости от реализации источника плейлиста, большинство операций изменения плейлиста могут быть асинхронными.

См. также QMediaContent.

Документация по типам членов

enum QMediaPlaylist::Error

Этот перечисление описывает коды ошибок QMediaPlaylist.

enum QMediaPlaylist::PlaybackMode

QMediaPlaylist::PlaybackMode описывает порядок воспроизведения элементов в плейлисте.

Документация по функциям-членам

QMediaPlaylist::QMediaPlaylist(QObject *parent = nullptr)

Создает новый объект плейлиста с заданным parent.

[virtual] QMediaPlaylist::~QMediaPlaylist()

Уничтожает плейлист.

bool QMediaPlaylist::addMedia(const QMediaContent &content)

Добавляет медиа-content в плейлист.

Возвращает true, если операция выполнена успешно, иначе возвращает false.

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

Добавляет несколько медиа-элементов items в плейлист.

Возвращает true, если операция выполнена успешно, иначе возвращает false.

bool QMediaPlaylist::clear()

Удаляет все элементы из плейлиста.

Возвращает true, если операция выполнена успешно, иначе возвращает false.

int QMediaPlaylist::currentIndex() const

Возвращает позицию текущего медиа-содержимого в плейлисте.

Примечание: Функция-геттер для свойства currentIndex.

См. также setCurrentIndex().

[signal] void QMediaPlaylist::currentIndexChanged(int position)

Сигнал, генерируемый при изменении позиции плейлиста на position.

Примечание: Сигнал уведомления для свойства currentIndex.

QMediaContent QMediaPlaylist::currentMedia() const

Возвращает текущее медиа-содержимое.

Примечание: Функция-геттер для свойства currentMedia.

[signal] void QMediaPlaylist::currentMediaChanged(const QMediaContent &content)

Сигнал, генерируемый при изменении текущего медиа на content.

Примечание: Сигнал уведомления для свойства currentMedia.

QMediaPlaylist::Error QMediaPlaylist::error() const

Возвращает последнее состояние ошибки.

QString QMediaPlaylist::errorString() const

Возвращает строку, описывающую последнее состояние ошибки.

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

Вставляет медиа-content в плейлист на позицию pos.

Возвращает true, если операция выполнена успешно, иначе возвращает false.

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

Вставляет несколько медиа-элементов items в плейлист на позицию pos.

Возвращает true, если операция выполнена успешно, иначе возвращает false.

bool QMediaPlaylist::isEmpty() const

Возвращает true, если плейлист не содержит элементов, иначе возвращает false.

См. также mediaCount().

bool QMediaPlaylist::isReadOnly() const

Возвращает true, если плейлист можно изменить, иначе возвращает false.

См. также mediaCount().

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

Загружает плейлист с помощью сетевого запроса request. Если format указан, он используется, в противном случае формат определяется из имени плейлиста и данных.

Новые элементы добавляются в плейлист.

Сигнал QMediaPlaylist::loaded() генерируется, если плейлист загружен успешно, в противном случае плейлист генерирует loadFailed().

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

Загружает плейлист из location. Если format указан, он используется, в противном случае формат определяется из имени расположения и данных.

Новые элементы добавляются в плейлист.

QMediaPlaylist::loaded() сигнал генерируется, если список воспроизведения загружен успешно, в противном случае список воспроизведения генерирует loadFailed().

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

Загрузить список воспроизведения из QIODevice device. Если format указан, он используется; в противном случае формат определяется по данным устройства.

Новые элементы добавляются в конец списка воспроизведения.

QMediaPlaylist::loaded() сигнал генерируется, если список воспроизведения загружен успешно, в противном случае список воспроизведения генерирует loadFailed().

[signal] void QMediaPlaylist::loadFailed()

Сигнал генерируется, если произошла ошибка загрузки списка воспроизведения.

[signal] void QMediaPlaylist::loaded()

Сигнал генерируется, когда завершается загрузка списка воспроизведения.

QMediaContent QMediaPlaylist::media(int index) const

Возвращает медиа-контент с индексом index в списке воспроизведения.

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

Сигнал генерируется, когда элементы должны быть вставлены с индекса start до индекса end.

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

Сигнал генерируется, когда элементы должны быть удалены с индекса start до индекса end.

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

Этот сигнал генерируется после изменения медиа-данных в списке воспроизведения между позициями start и end включительно.

int QMediaPlaylist::mediaCount() const

Возвращает количество элементов в списке воспроизведения.

См. также isEmpty().

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

Этот сигнал генерируется после вставки медиа-данных в список воспроизведения. Новые элементы находятся между позициями start и end включительно.

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

Переопределено из QMediaBindableInterface::mediaObject().

Возвращает экземпляр QMediaObject, к которому привязан этот QMediaPlaylist, или 0 в противном случае.

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

Этот сигнал генерируется после удаления медиа-данных из списка воспроизведения. Удаленные элементы находятся между позициями start и end включительно.

bool QMediaPlaylist::moveMedia(int from, int to)

Перемещает элемент из позиции from на позицию to.

Возвращает true, если операция выполнена успешно, иначе false.

Эта функция была добавлена в Qt 5.7.

[slot] void QMediaPlaylist::next()

Переходит к следующему элементу в списке воспроизведения.

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

Возвращает индекс элемента, который станет текущим после вызова next() steps раз.

Возвращаемое значение зависит от размера списка воспроизведения, текущей позиции и режима воспроизведения.

См. также QMediaPlaylist::playbackMode() и previousIndex().

[signal] void QMediaPlaylist::playbackModeChanged(QMediaPlaylist::PlaybackMode mode)

Сигнал генерируется при изменении режима воспроизведения на mode.

Примечание: Сигнал уведомления для свойства playbackMode.

[slot] void QMediaPlaylist::previous()

Возвращается к предыдущему элементу в списке воспроизведения.

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

Возвращает индекс элемента, который станет текущим после вызова previous() steps раз.

См. также QMediaPlaylist::playbackMode() и nextIndex().

bool QMediaPlaylist::removeMedia(int pos)

Удаляет элемент из списка воспроизведения по позиции pos.

Возвращает true, если операция выполнена успешно, иначе false.

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

Удаляет элементы из списка воспроизведения с позиции start до позиции end включительно.

Возвращает true, если операция выполнена успешно, иначе false.

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

Сохранить список воспроизведения в location. Если format указан, он используется; в противном случае формат определяется по имени расположения.

Возвращает true, если список воспроизведения был сохранен успешно, иначе false.

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

Сохранить список воспроизведения в QIODevice device с использованием формата format.

Возвращает true, если список воспроизведения был сохранен успешно, иначе false.

[slot] void QMediaPlaylist::setCurrentIndex(int playlistPosition)

Активировать медиа-контент из списка воспроизведения по позиции playlistPosition.

Примечание: Функция-сеттер для свойства currentIndex.

См. также currentIndex().

[slot] void QMediaPlaylist::shuffle()

Перемешать элементы в списке воспроизведения.