Класс 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 будет истинным, если мультимедийный объект имеет метаданные.
[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_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.14/qmetadatareadercontrol.html