Changed metadata keys type from enum to QString.
This allows to combine metaData and extendedMetaData and simplify metadata handling on both backend and application sides. Change-Id: I136eedc86c215be3485db101c43069ca7c82101b Reviewed-by: Michael Goddard <michael.goddard@nokia.com>
This commit is contained in:
committed by
Qt by Nokia
parent
382ba7d4f4
commit
8ff5b88b27
@@ -136,21 +136,10 @@ QCameraImageCaptureControl::~QCameraImageCaptureControl()
|
||||
has been captured and a \a preview is available.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QCameraImageCaptureControl::imageMetadataAvailable(int id, QtMultimedia::MetaData key, const QVariant &value)
|
||||
|
||||
Signals that a metadata for an image with request \a id is available.
|
||||
This signal is emitted for metadata \a value with a \a key listed in QtMultimedia::MetaData enum.
|
||||
|
||||
This signal should be emitted between imageExposed and imageSaved signals.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QCameraImageCaptureControl::imageMetadataAvailable(int id, const QString &key, const QVariant &value)
|
||||
|
||||
Signals that a metadata for an image with request \a id is available.
|
||||
This signal is emitted for extended metadata \a value with a \a key not listed in QtMultimedia::MetaData enum.
|
||||
|
||||
This signal should be emitted between imageExposed and imageSaved signals.
|
||||
*/
|
||||
|
||||
|
||||
@@ -76,7 +76,6 @@ Q_SIGNALS:
|
||||
|
||||
void imageExposed(int id);
|
||||
void imageCaptured(int id, const QImage &preview);
|
||||
void imageMetadataAvailable(int id, QtMultimedia::MetaData key, const QVariant &value);
|
||||
void imageMetadataAvailable(int id, const QString &key, const QVariant &value);
|
||||
void imageAvailable(int id, const QVideoFrame &buffer);
|
||||
void imageSaved(int id, const QString &fileName);
|
||||
|
||||
@@ -125,11 +125,12 @@ QMediaStreamsControl::~QMediaStreamsControl()
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QMediaStreamsControl::metaData(int stream, QtMultimedia::MetaData key)
|
||||
\fn QMediaStreamsControl::metaData(int stream, const QString &key)
|
||||
|
||||
Returns the meta-data value of \a key for a given \a stream.
|
||||
|
||||
Useful metadata keya are QtMultimedia::Title, QtMultimedia::Description and QtMultimedia::Language.
|
||||
Useful metadata keys are QtMultimedia::MetaData::Title,
|
||||
QtMultimedia::MetaData::Description and QtMultimedia::MetaData::Language.
|
||||
*/
|
||||
|
||||
/*!
|
||||
|
||||
@@ -67,7 +67,7 @@ public:
|
||||
virtual int streamCount() = 0;
|
||||
virtual StreamType streamType(int streamNumber) = 0;
|
||||
|
||||
virtual QVariant metaData(int streamNumber, QtMultimedia::MetaData key) = 0;
|
||||
virtual QVariant metaData(int streamNumber, const QString &key) = 0;
|
||||
|
||||
virtual bool isActive(int streamNumber) = 0;
|
||||
virtual void setActive(int streamNumber, bool state) = 0;
|
||||
|
||||
@@ -59,9 +59,8 @@ QT_BEGIN_NAMESPACE
|
||||
If a QMediaService can provide read or write access to the meta-data of
|
||||
its current media it will implement QMetaDataReaderControl. This control
|
||||
provides functions for both retrieving and setting meta-data values.
|
||||
Meta-data may be addressed by the well defined keys in the
|
||||
QtMultimedia::MetaData enumeration using the metaData() functions, or by
|
||||
string keys using the extendedMetaData() functions.
|
||||
Meta-data may be addressed by the keys defined in the
|
||||
QtMultimedia::MetaData namespace.
|
||||
|
||||
The functionality provided by this control is exposed to application
|
||||
code by the meta-data members of QMediaObject, and so meta-data access
|
||||
@@ -112,7 +111,7 @@ QMetaDataReaderControl::~QMetaDataReaderControl()
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QVariant QMetaDataReaderControl::metaData(QtMultimedia::MetaData key) const
|
||||
\fn QVariant QMetaDataReaderControl::metaData(const QString &key) const
|
||||
|
||||
Returns the meta-data for the given \a key.
|
||||
*/
|
||||
@@ -123,22 +122,6 @@ QMetaDataReaderControl::~QMetaDataReaderControl()
|
||||
Returns a list of keys there is meta-data available for.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QMetaDataReaderControl::extendedMetaData(const QString &key) const
|
||||
|
||||
Returns the metaData for an abitrary string \a key.
|
||||
|
||||
The valid selection of keys for extended meta-data is determined by the provider and the meaning
|
||||
and type may differ between providers.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QMetaDataReaderControl::availableExtendedMetaData() const
|
||||
|
||||
Returns a list of keys there is extended meta-data available for.
|
||||
*/
|
||||
|
||||
|
||||
/*!
|
||||
\fn void QMetaDataReaderControl::metaDataChanged()
|
||||
|
||||
|
||||
@@ -66,11 +66,8 @@ public:
|
||||
|
||||
virtual bool isMetaDataAvailable() const = 0;
|
||||
|
||||
virtual QVariant metaData(QtMultimedia::MetaData key) const = 0;
|
||||
virtual QList<QtMultimedia::MetaData> availableMetaData() const = 0;
|
||||
|
||||
virtual QVariant extendedMetaData(const QString &key) const = 0;
|
||||
virtual QStringList availableExtendedMetaData() const = 0;
|
||||
virtual QVariant metaData(const QString &key) const = 0;
|
||||
virtual QStringList availableMetaData() const = 0;
|
||||
|
||||
Q_SIGNALS:
|
||||
void metaDataChanged();
|
||||
|
||||
@@ -59,9 +59,8 @@ QT_BEGIN_NAMESPACE
|
||||
If a QMediaService can provide write access to the meta-data of its
|
||||
current media it will implement QMetaDataWriterControl. This control
|
||||
provides functions for both retrieving and setting meta-data values.
|
||||
Meta-data may be addressed by the well defined keys in the
|
||||
QtMultimedia::MetaData enumeration using the metaData() functions, or
|
||||
by string keys using the extendedMetaData() functions.
|
||||
Meta-data may be addressed by the keys defined in the
|
||||
QtMultimedia::MetaData namespace.
|
||||
|
||||
The functionality provided by this control is exposed to application code
|
||||
by the meta-data members of QMediaObject, and so meta-data access is
|
||||
@@ -119,13 +118,13 @@ QMetaDataWriterControl::~QMetaDataWriterControl()
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QVariant QMetaDataWriterControl::metaData(QtMultimedia::MetaData key) const
|
||||
\fn QVariant QMetaDataWriterControl::metaData(const QString &key) const
|
||||
|
||||
Returns the meta-data for the given \a key.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn void QMetaDataWriterControl::setMetaData(QtMultimedia::MetaData key, const QVariant &value)
|
||||
\fn void QMetaDataWriterControl::setMetaData(const QString &key, const QVariant &value)
|
||||
|
||||
Sets the \a value of the meta-data element with the given \a key.
|
||||
*/
|
||||
@@ -136,31 +135,6 @@ QMetaDataWriterControl::~QMetaDataWriterControl()
|
||||
Returns a list of keys there is meta-data available for.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QMetaDataWriterControl::extendedMetaData(const QString &key) const
|
||||
|
||||
Returns the meta-data for an abitrary string \a key.
|
||||
|
||||
The valid selection of keys for extended meta-data is determined by the provider and the meaning
|
||||
and type may differ between providers.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QMetaDataWriterControl::setExtendedMetaData(const QString &key, const QVariant &value)
|
||||
|
||||
Change the value of the meta-data element with an abitrary string \a key to \a value.
|
||||
|
||||
The valid selection of keys for extended meta-data is determined by the provider and the meaning
|
||||
and type may differ between providers.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QMetaDataWriterControl::availableExtendedMetaData() const
|
||||
|
||||
Returns a list of keys there is extended meta-data available for.
|
||||
*/
|
||||
|
||||
|
||||
/*!
|
||||
\fn void QMetaDataWriterControl::metaDataChanged()
|
||||
|
||||
|
||||
@@ -67,14 +67,9 @@ public:
|
||||
virtual bool isWritable() const = 0;
|
||||
virtual bool isMetaDataAvailable() const = 0;
|
||||
|
||||
virtual QVariant metaData(QtMultimedia::MetaData key) const = 0;
|
||||
virtual void setMetaData(QtMultimedia::MetaData key, const QVariant &value) = 0;
|
||||
virtual QList<QtMultimedia::MetaData> availableMetaData() const = 0;
|
||||
|
||||
virtual QVariant extendedMetaData(const QString &key) const = 0;
|
||||
virtual void setExtendedMetaData(const QString &key, const QVariant &value) = 0;
|
||||
virtual QStringList availableExtendedMetaData() const = 0;
|
||||
|
||||
virtual QVariant metaData(const QString &key) const = 0;
|
||||
virtual void setMetaData(const QString &key, const QVariant &value) = 0;
|
||||
virtual QStringList availableMetaData() const = 0;
|
||||
|
||||
Q_SIGNALS:
|
||||
void metaDataChanged();
|
||||
|
||||
Reference in New Issue
Block a user