Тип 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 clear()
• bool insertItem(index, source)
• url itemSource(index)
• load(location, format)
• next()
• int nextIndex(steps)
• previous()
• int previousIndex(steps)
• bool removeItem(index)
• 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 clear()

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

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

bool insertItem(index, source)

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

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

url itemSource(index)

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

load(location, format)

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

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

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

next()

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

int nextIndex(steps)

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

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

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

previous()

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

int previousIndex(steps)

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

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

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

bool removeItem(index)

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

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

bool save(location, format)

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

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

shuffle()

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