Класс QMetaDataReaderControl

Класс QMetaDataReaderControl предоставляет чтение метаданных медиа QMediaService. Подробнее...

Этот класс устарел. Он предоставляется для обеспечения работы старого кода. Мы настоятельно рекомендуем не использовать его в новом коде.

• Список всех членов, включая унаследованные

Открытые функции

Сигналы

Защищенные функции

Макросы

Подробное описание

Если 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.