Класс QMetaDataWriterControl

Класс QMetaDataWriterControl предоставляет доступ для записи в метаданные медиа QMediaService. Подробнее...

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

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

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

Сигналы

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

Макросы

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

Если QMediaService может предоставить доступ для записи в метаданные текущего медиа, он реализует QMetaDataWriterControl. Этот контроллер предоставляет функции для получения и установки значений метаданных. Доступ к метаданным осуществляется по ключам, определённым в пространстве имён QMediaMetaData.

Функциональность этого контроллера доступна коду приложения через члены метаданных класса QMediaObject, поэтому доступ к метаданным потенциально доступен во всех классах объектов медиа. Любой сервис медиа может реализовывать QMetaDataControl.

Имя интерфейса QMetaDataWriterControl равно org.qt-project.qt.metadatawritercontrol/5.0, как определено в QMetaDataWriterControl_iid.

См. также QMediaService::requestControl() и QMediaObject.

Документация по функциям-членам

[protected] QMetaDataWriterControl::QMetaDataWriterControl(QObject *parent = nullptr)

Конструктор QMetaDataWriterControl с параметром parent. Этот класс предназначен как базовый класс для поставщиков метаданных специфичных для службы, поэтому этот конструктор защищён.

[signal] void QMetaDataWriterControl::metaDataAvailableChanged(bool available)

Сигнал о том, что доступность метаданных изменилась. available будет истинным, если мультимедийный объект имеет метаданные.

[signal] void QMetaDataWriterControl::metaDataChanged(const QString &key, const QVariant &value)

Сигнал об изменении элемента метаданных value с заданным ключом key.

Примечание: Сигнал metaDataChanged перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную функцию для получения указателя на функцию, как показано в этом примере:

connect(metaDataWriterControl, QOverload<const QString &, const QVariant &>::of(&QMetaDataWriterControl::metaDataChanged),
    [=](const QString &key, const QVariant &value){ /* ... */ });

[signal] void QMetaDataWriterControl::metaDataChanged()

Сигнал об изменении метаданных.

Если изменяются несколько элементов метаданных, для каждого из них будет выпущен сигнал metaDataChanged(const QString &key, const QVariant &value), а signal metaDataChanged() выпущен один раз.

Примечание: Сигнал metaDataChanged перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную функцию для получения указателя на функцию, как показано в этом примере:

connect(metaDataWriterControl, QOverload<>::of(&QMetaDataWriterControl::metaDataChanged),
    [=](){ /* ... */ });

[signal] void QMetaDataWriterControl::writableChanged(bool writable)

Сигнал об изменении статуса возможности записи метаданных. writable будет истинным, если элементы метаданных могут быть добавлены или изменены.

[virtual] QMetaDataWriterControl::~QMetaDataWriterControl()

Уничтожает контроллер записи метаданных.

[pure virtual] QStringList QMetaDataWriterControl::availableMetaData() const

Возвращает список ключей, для которых доступны метаданные.

[pure virtual] bool QMetaDataWriterControl::isMetaDataAvailable() const

Определяет, доступны ли метаданные из службы медиа.

Возвращает true, если метаданные доступны, и false в противном случае.

[pure virtual] bool QMetaDataWriterControl::isWritable() const

Определяет, можно ли редактировать метаданные службы медиа.

Возвращает true, если метаданные могут быть изменены, и false в противном случае.

[pure virtual] QVariant QMetaDataWriterControl::metaData(const QString &key) const

Возвращает метаданные для заданного ключа key.

См. также setMetaData().

[pure virtual] void QMetaDataWriterControl::setMetaData(const QString &key, const QVariant &value)

Устанавливает значение value элемента метаданных с заданным ключом key.

См. также metaData().