Тип 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, Аудио и Видео. Он может использоваться в качестве источника данных для элементов отображения (например, 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, Аудио и Видео.

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

currentIndex : int

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

currentItemsource : url

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

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

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

errorString : строка

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

itemCount : int

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

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

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

readOnly : bool

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

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

itemAboutToBeInserted(start, end)

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

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

itemAboutToBeRemoved(start, end)

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

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

itemChanged(start, end)

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

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

itemInserted(start, end)

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

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

itemRemoved(start, end)

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

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

loadFailed()

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

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

loaded()

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

Соответствующий обработчик — 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()

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