Тип QML Playlist

Для указания списка медиафайлов, которые нужно воспроизвести. Подробнее...

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

Свойства

• currentIndex : int
• currentItemsource : url
• error : перечисление
• errorString : строка
• itemCount : int
• playbackMode : перечисление
• readOnly : bool

Сигналы

• itemAboutToBeInserted(start, end)
• itemAboutToBeRemoved(start, end)
• itemChanged(start, end)
• itemInserted(start, end)
• itemRemoved(start, end)
• loadFailed()
• loaded()

Методы

• bool addItem(source)
• bool addItems(sources)
• bool clear()
• bool insertItem(index, source)
• bool insertItems(index, sources)
• url itemSource(index)
• load(location, format)
• bool moveItem(from, to)
• next()
• int nextIndex(steps)
• previous()
• int previousIndex(steps)
• bool removeItem(index)
• bool removeItems(int start, int end)
• bool save(location, format)
• shuffle()

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

Тип Playlist предоставляет способ воспроизведения списка медиафайлов с помощью типов MediaPlayer, Audio и Video. Он может использоваться в качестве источника данных для элементов отображения (таких как ListView) и других элементов, взаимодействующих с данными модели (например, Repeater). При использовании в качестве модели данных URL-адрес источника каждого элемента плейлиста можно получить с помощью source роли.

Item {
    width: 400;
    height: 300;

    Audio {
        id: player;
        playlist: Playlist {
            id: playlist
            PlaylistItem { source: "song1.ogg"; }
            PlaylistItem { source: "song2.ogg"; }
            PlaylistItem { source: "song3.ogg"; }
        }
    }

    ListView {
        model: playlist;
        delegate: Text {
            font.pixelSize: 16;
            text: source;
        }
    }

    MouseArea {
        anchors.fill: parent;
        onPressed: {
            if (player.playbackState != Audio.PlayingState) {
                player.play();
            } else {
                player.pause();
            }
        }
    }
}

См. также MediaPlayer, Audio и Video.

Документация свойств

currentIndex : int

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

currentItemsource : url

Это свойство содержит URL-адрес источника текущего элемента в плейлисте.

error : перечисление

Это свойство содержит состояние ошибки плейлиста.

errorString : строка

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

itemCount : int

Это свойство содержит количество элементов в плейлисте.

playbackMode : перечисление

Это свойство содержит порядок воспроизведения элементов в плейлисте.

readOnly : bool

Это свойство указывает, можно ли изменить плейлист.

Документация сигналов

itemAboutToBeInserted(start, end)

Этот сигнал испускается при вставке элементов в плейлист с позиций start до end.

Соответствующий обработчик — onItemAboutToBeInserted.

Примечание: Соответствующий обработчик — onItemAboutToBeInserted.

itemAboutToBeRemoved(start, end)

Этот сигнал испускается при удалении элементов из плейлиста с позиций start до end.

Соответствующий обработчик — onItemAboutToBeRemoved.

Примечание: Соответствующий обработчик — onItemAboutToBeRemoved.

itemChanged(start, end)

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

Соответствующий обработчик — onItemChanged.

Примечание: Соответствующий обработчик — onItemChanged.

itemInserted(start, end)

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

Соответствующий обработчик — onItemInserted.

Примечание: Соответствующий обработчик — onItemInserted.

itemRemoved(start, end)

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

Соответствующий обработчик — onMediaRemoved.

Примечание: Соответствующий обработчик — onItemRemoved.

loadFailed()

Этот сигнал испускается при неудачной загрузке плейлиста. error и errorString можно проверить для получения дополнительной информации о сбое.

Соответствующий обработчик — onLoadFailed.

Примечание: Соответствующий обработчик — onLoadFailed.

loaded()

Этот сигнал испускается при успешной загрузке плейлиста.

Соответствующий обработчик — onLoaded.

Примечание: Соответствующий обработчик — onLoaded.

Документация методов

bool addItem(source)

Добавляет URL source в конец плейлиста.

Возвращает true, если source успешно добавлен.

bool addItems(sources)

Добавляет список URL-адресов в sources в конец плейлиста.

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

Этот метод был введён в Qt 5.7.

bool clear()

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

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

bool insertItem(index, source)

Вставляет URL source в плейлист на указанный index.

Возвращает true, если source успешно добавлен.

bool insertItems(index, sources)

Вставляет список URL-адресов в sources в плейлист по заданному index.

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

Этот метод был представлен в Qt 5.7.

url itemSource(index)

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

load(location, format)

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

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

onloaded() генерируется, если плейлист загружен успешно, в противном случае onLoadFailed() генерируется с определёнными значениями error и errorString.

bool moveItem(from, to)

Перемещает элемент с индексом from на индекс to.

Возвращает true если элемент перемещён успешно.

Этот метод был представлен в Qt 5.7.

next()

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

int nextIndex(steps)

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

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

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

previous()

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

int previousIndex(steps)

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

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

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

bool removeItem(index)

Удаляет элемент по заданному index из плейлиста.

Возвращает true если элемент удалён успешно.

bool removeItems(int start, int end)

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

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

Этот метод был представлен в Qt 5.7.

bool save(location, format)

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

Возвращает true, если плейлист сохранён успешно.

shuffle()

Перемешивает элементы в плейлисте.