Класс QMediaPlaylist
Класс QMediaPlaylist предоставляет список медиа-контента для воспроизведения. Подробнее...
| Заголовок: | #include <QMediaPlaylist> |
| qmake: | QT += multimedia |
| Наследует: | QObject и QMediaBindableInterface |
Общедоступные типы
| перечисление | Ошибка { НетОшибки, ОшибкаФормата, НеПоддерживаемыйФормат, ОшибкаСети, ОшибкаДоступа } |
| перечисление | РежимВоспроизведения { ТекущийЭлементОдинРаз, ТекущийЭлементПоЦиклу, Последовательно, ПоЦиклу, Случайно } |
Свойства
- currentIndex : int
- currentMedia : const QMediaContent
- режимВоспроизведения : QMediaPlaylist::РежимВоспроизведения
- 1 свойство унаследовано от QObject
Общедоступные функции
| QMediaPlaylist(QObject *parent = nullptr) | |
| virtual | ~QMediaPlaylist() |
| bool | addMedia(const QMediaContent &content) |
| bool | addMedia(const QList<QMediaContent> &items) |
| bool | очистить() |
| int | currentIndex() const |
| QMediaContent | currentMedia() const |
| QMediaPlaylist::Ошибка | error() const |
| QString | ошибкаСтроки() const |
| bool | вставитьМедиа(int pos, const QMediaContent &content) |
Переопределенные общедоступные функции
| virtual QMediaObject * | mediaObject() const override |
- 31 общедоступных функций, унаследованных от QObject
- 1 общедоступная функция, унаследованная от QMediaBindableInterface
Общедоступные слоты
| void | next() |
| void | previous() |
| void | setCurrentIndex(int playlistPosition) |
| void | shuffle() |
- 1 общедоступный слот, унаследованный от QObject
Сигналы
| void | currentIndexChanged(int position) |
| void | currentMediaChanged(const QMediaContent &content) |
| void | loadFailed() |
| void | loaded() |
| void | mediaAboutToBeInserted(int start, int end) |
| void | mediaAboutToBeRemoved(int start, int end) |
| void | mediaChanged(int start, int end) |
| void | mediaInserted(int start, int end) |
| void | mediaRemoved(int start, int end) |
| void | playbackModeChanged(QMediaPlaylist::PlaybackMode mode) |
- 2 сигнала, унаследованные от QObject
Статические общедоступные члены
| const QMetaObject | staticMetaObject |
- 9 статических общедоступных членов, унаследованных от QObject
Защищенные переменные
| QMediaPlaylistPrivate * | d_ptr |
Дополнительные унаследованные члены
- 9 защищённых функций унаследовано от QObject
- 1 защищённая функция унаследовано от QMediaBindableInterface
Подробное описание
Класс 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.
Документация типов членов
перечисление QMediaPlaylist::Error
Это перечисление описывает коды ошибок QMediaPlaylist.
| Константа | Значение | Описание |
|---|---|---|
QMediaPlaylist::NoError |
0 |
Нет ошибок. |
QMediaPlaylist::FormatError |
1 |
Ошибка формата. |
QMediaPlaylist::FormatNotSupportedError |
2 |
Неподдерживаемый формат. |
QMediaPlaylist::NetworkError |
3 |
Ошибка сети. |
QMediaPlaylist::AccessDeniedError |
4 |
Ошибка доступа запрещён. |
перечисление QMediaPlaylist::PlaybackMode
QMediaPlaylist::PlaybackMode описывает порядок воспроизведения элементов в списке воспроизведения.
| Константа | Значение | Описание |
|---|---|---|
QMediaPlaylist::CurrentItemOnce |
0 |
Текущий элемент воспроизводится только один раз. |
QMediaPlaylist::CurrentItemInLoop |
1 |
Текущий элемент воспроизводится циклически. |
QMediaPlaylist::Sequential |
2 |
Воспроизведение начинается с текущего элемента и переходит к каждому последующему элементу до достижения последнего, после чего останавливается. Следующий элемент — пустой, когда воспроизводится последний. |
QMediaPlaylist::Loop |
3 |
Воспроизведение возобновляется с первого элемента после завершения воспроизведения последнего. |
QMediaPlaylist::Random |
4 |
Воспроизведение элементов в случайном порядке. |
Документация свойств
currentIndex : int
Текущая позиция.
Функции доступа:
| int | currentIndex() const |
| void | setCurrentIndex(int playlistPosition) |
Сигнал оповещения:
| void | currentIndexChanged(int position) |
currentMedia : const QMediaContent
Текущий медиа-контент.
Функции доступа:
| QMediaContent | currentMedia() const |
Сигнал оповещения:
| void | currentMediaChanged(const QMediaContent &content) |
playbackMode : QMediaPlaylist::PlaybackMode
Это свойство определяет порядок воспроизведения элементов в списке воспроизведения.
Функции доступа:
| QMediaPlaylist::PlaybackMode | playbackMode() const |
| void | setPlaybackMode(QMediaPlaylist::PlaybackMode mode) |
Сигнал оповещения:
| void | playbackModeChanged(QMediaPlaylist::PlaybackMode mode) |
См. также 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 указан, он используется, в противном случае формат определяется по имени и данным location.
Новые элементы добавляются в конец плейлиста.
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 указан, он используется, в противном случае формат определяется по имени location.
Возвращает 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()
Перемешать элементы в плейлисте.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qmediaplaylist.html
