1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QABSTRACTMEDIAOBJECT_H
41#define QABSTRACTMEDIAOBJECT_H
42
43#include <QtCore/qobject.h>
44#include <QtCore/qstringlist.h>
45
46#include <QtMultimedia/qtmultimediaglobal.h>
47#include <QtMultimedia/qmultimedia.h>
48
49QT_BEGIN_NAMESPACE
50
51
52class QMediaService;
53class QMediaBindableInterface;
54
55class QMediaObjectPrivate;
56class Q_MULTIMEDIA_EXPORT QMediaObject : public QObject
57{
58 Q_OBJECT
59 Q_PROPERTY(int notifyInterval READ notifyInterval WRITE setNotifyInterval NOTIFY notifyIntervalChanged)
60public:
61 ~QMediaObject();
62
63 virtual bool isAvailable() const;
64 virtual QMultimedia::AvailabilityStatus availability() const;
65
66 virtual QMediaService* service() const;
67
68 int notifyInterval() const;
69 void setNotifyInterval(int milliSeconds);
70
71 virtual bool bind(QObject *);
72 virtual void unbind(QObject *);
73
74 bool isMetaDataAvailable() const;
75
76 QVariant metaData(const QString &key) const;
77 QStringList availableMetaData() const;
78
79Q_SIGNALS:
80 void notifyIntervalChanged(int milliSeconds);
81
82 void metaDataAvailableChanged(bool available);
83 void metaDataChanged();
84 void metaDataChanged(const QString &key, const QVariant &value);
85
86 void availabilityChanged(bool available);
87 void availabilityChanged(QMultimedia::AvailabilityStatus availability);
88
89protected:
90 QMediaObject(QObject *parent, QMediaService *service);
91 QMediaObject(QMediaObjectPrivate &dd, QObject *parent, QMediaService *service);
92
93 void addPropertyWatch(QByteArray const &name);
94 void removePropertyWatch(QByteArray const &name);
95
96 QMediaObjectPrivate *d_ptr;
97
98private:
99 void setupControls();
100
101 Q_DECLARE_PRIVATE(QMediaObject)
102 Q_PRIVATE_SLOT(d_func(), void _q_notify())
103 Q_PRIVATE_SLOT(d_func(), void _q_availabilityChanged())
104};
105
106
107QT_END_NAMESPACE
108
109
110#endif // QABSTRACTMEDIAOBJECT_H
111