Тип 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 добавлены успешно.

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

bool clear()

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

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

bool insertItem(index, source)

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

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

bool insertItems(index, sources)

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

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

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

url itemSource(index)

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

load(location, format)

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

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

onloaded() генерируется, если плейлист загружен успешно, в противном случае генерируется onLoadFailed() с соответствующим значением ошибки и описания ошибки.

bool moveItem(from, to)

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

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

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

next()

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

int nextIndex(steps)

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

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

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

previous()

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

int previousIndex(steps)

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

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

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

bool removeItem(index)

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

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

bool removeItems(int start, int end)

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

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

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

bool save(location, format)

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

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

shuffle()

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