Тип 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(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 источника элемента в плейлисте по заданному индексу.

load(location, format)

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

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

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

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)

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

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

bool removeItems(start, int end)

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

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

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

bool save(location, format)

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

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

shuffle()

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