Класс 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) высылается для каждого из них, а сигнал 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().