Класс QMetaDataReaderControl
Класс QMetaDataReaderControl предоставляет доступ для чтения метаданных медиа QMediaService. Подробнее...
| Заголовок: | #include <QMetaDataReaderControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Открытые функции
| virtual | ~QMetaDataReaderControl() |
| virtual QStringList | availableMetaData() const = 0 |
| virtual bool | isMetaDataAvailable() const = 0 |
| virtual QVariant | metaData(const QString &key) const = 0 |
Сигналы
| void | metaDataAvailableChanged(bool available) |
| void | metaDataChanged(const QString &key, const QVariant &value) |
| void | metaDataChanged() |
Защищенные функции
| QMetaDataReaderControl(QObject *parent = nullptr) |
Макросы
| QMetaDataReaderControl_iid |
Подробное описание
Если QMediaService может предоставить доступ для чтения или записи к метаданным текущего медиа, он реализует QMetaDataReaderControl. Этот класс предоставляет функции для получения и установки значений метаданных. Доступ к метаданным осуществляется по ключам, определенным в пространстве имен QMediaMetaData.
Функциональность этого класса доступна коду приложения через члены метаданных QMediaObject, и поэтому доступ к метаданным потенциально возможен в любом из классов объектов медиа. Любой медиа-сервис может реализовывать QMetaDataReaderControl.
Имя интерфейса QMetaDataReaderControl равно org.qt-project.qt.metadatareadercontrol/5.0, как определено в QMetaDataReaderControl_iid.
См. также QMediaService::requestControl() и QMediaObject.
Документация по функциям-членам
[protected] QMetaDataReaderControl::QMetaDataReaderControl(QObject *parent = nullptr)
Создает экземпляр QMetaDataReaderControl с parent. Этот класс предназначен в качестве базового класса для поставщиков метаданных конкретных сервисов, поэтому этот конструктор защищен.
[signal] void QMetaDataReaderControl::metaDataAvailableChanged(bool available)
Сигнализирует изменение доступности метаданных, available будет true, если мультимедийный объект имеет метаданные.
[signal] void QMetaDataReaderControl::metaDataChanged(const QString &key, const QVariant &value)
Сигнализирует изменение одного элемента метаданных value с заданным key.
Примечание: Сигнал metaDataChanged перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную утилиту для получения указателя на функцию, как показано в этом примере:
connect(metaDataReaderControl, QOverload<const QString &, const QVariant &>::of(&QMetaDataReaderControl::metaDataChanged),
[=](const QString &key, const QVariant &value){ /* ... */ });
[signal] void QMetaDataReaderControl::metaDataChanged()
Сигнализирует изменение метаданных.
Если изменяются несколько элементов метаданных, сигнал metaDataChanged(const QString &key, const QVariant &value) генерируется для каждого из них, а сигнал metaDataChanged() генерируется один раз.
Примечание: Сигнал metaDataChanged перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную утилиту для получения указателя на функцию, как показано в этом примере:
connect(metaDataReaderControl, QOverload<>::of(&QMetaDataReaderControl::metaDataChanged),
[=](){ /* ... */ });
[virtual] QMetaDataReaderControl::~QMetaDataReaderControl()
Уничтожает объект метаданных.
[pure virtual] QStringList QMetaDataReaderControl::availableMetaData() const
Возвращает список ключей, для которых доступны метаданные.
[pure virtual] bool QMetaDataReaderControl::isMetaDataAvailable() const
Определяет, доступны ли метаданные из медиа-сервиса.
Возвращает true, если метаданные доступны, и false в противном случае.
[pure virtual] QVariant QMetaDataReaderControl::metaData(const QString &key) const
Возвращает метаданные для заданного key.
Документация по макросам
QMetaDataReaderControl::QMetaDataReaderControl_iid
org.qt-project.qt.metadatareadercontrol/5.0
Определяет имя интерфейса класса QMetaDataReaderControl.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qmetadatareadercontrol.html