| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #ifndef QMEDIAPLAYLIST_H |
| #define QMEDIAPLAYLIST_H |
| |
| #include <QtCore/qobject.h> |
| |
| #include <QtMultimedia/qmediacontent.h> |
| #include <QtMultimedia/qmediaobject.h> |
| #include <QtMultimedia/qmediabindableinterface.h> |
| #include <QtMultimedia/qmediaenumdebug.h> |
| |
| |
| QT_BEGIN_NAMESPACE |
| |
| |
| class QMediaPlaylistProvider; |
| |
| class QMediaPlaylistPrivate; |
| class Q_MULTIMEDIA_EXPORT QMediaPlaylist : public QObject, public QMediaBindableInterface |
| { |
| Q_OBJECT |
| Q_INTERFACES(QMediaBindableInterface) |
| Q_PROPERTY(QMediaPlaylist::PlaybackMode playbackMode READ playbackMode WRITE setPlaybackMode NOTIFY playbackModeChanged) |
| Q_PROPERTY(QMediaContent currentMedia READ currentMedia NOTIFY currentMediaChanged) |
| Q_PROPERTY(int currentIndex READ currentIndex WRITE setCurrentIndex NOTIFY currentIndexChanged) |
| Q_ENUMS(PlaybackMode Error) |
| |
| public: |
| enum PlaybackMode { CurrentItemOnce, CurrentItemInLoop, Sequential, Loop, Random }; |
| enum Error { NoError, FormatError, FormatNotSupportedError, NetworkError, AccessDeniedError }; |
| |
| explicit QMediaPlaylist(QObject *parent = nullptr); |
| virtual ~QMediaPlaylist(); |
| |
| QMediaObject *mediaObject() const override; |
| |
| PlaybackMode playbackMode() const; |
| void setPlaybackMode(PlaybackMode mode); |
| |
| int currentIndex() const; |
| QMediaContent currentMedia() const; |
| |
| int nextIndex(int steps = 1) const; |
| int previousIndex(int steps = 1) const; |
| |
| QMediaContent media(int index) const; |
| |
| int mediaCount() const; |
| bool isEmpty() const; |
| bool isReadOnly() const; |
| |
| bool addMedia(const QMediaContent &content); |
| bool addMedia(const QList<QMediaContent> &items); |
| bool insertMedia(int index, const QMediaContent &content); |
| bool insertMedia(int index, const QList<QMediaContent> &items); |
| bool moveMedia(int from, int to); |
| bool removeMedia(int pos); |
| bool removeMedia(int start, int end); |
| bool clear(); |
| |
| void load(const QNetworkRequest &request, const char *format = nullptr); |
| void load(const QUrl &location, const char *format = nullptr); |
| void load(QIODevice *device, const char *format = nullptr); |
| |
| bool save(const QUrl &location, const char *format = nullptr); |
| bool save(QIODevice * device, const char *format); |
| |
| Error error() const; |
| QString errorString() const; |
| |
| public Q_SLOTS: |
| void shuffle(); |
| |
| void next(); |
| void previous(); |
| |
| void setCurrentIndex(int index); |
| |
| Q_SIGNALS: |
| void currentIndexChanged(int index); |
| void playbackModeChanged(QMediaPlaylist::PlaybackMode mode); |
| void currentMediaChanged(const QMediaContent&); |
| |
| void mediaAboutToBeInserted(int start, int end); |
| void mediaInserted(int start, int end); |
| void mediaAboutToBeRemoved(int start, int end); |
| void mediaRemoved(int start, int end); |
| void mediaChanged(int start, int end); |
| |
| void loaded(); |
| void loadFailed(); |
| |
| protected: |
| bool setMediaObject(QMediaObject *object) override; |
| QMediaPlaylistPrivate *d_ptr; |
| |
| private: |
| Q_DECLARE_PRIVATE(QMediaPlaylist) |
| Q_PRIVATE_SLOT(d_func(), void _q_loadFailed(QMediaPlaylist::Error, const QString &)) |
| }; |
| |
| QT_END_NAMESPACE |
| |
| Q_DECLARE_METATYPE(QMediaPlaylist::PlaybackMode) |
| Q_DECLARE_METATYPE(QMediaPlaylist::Error) |
| |
| Q_MEDIA_ENUM_DEBUG(QMediaPlaylist, PlaybackMode) |
| Q_MEDIA_ENUM_DEBUG(QMediaPlaylist, Error) |
| |
| #endif // QMEDIAPLAYLIST_H |