Тип 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.

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

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