Класс 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 будет true, если объект мультимедиа содержит метаданные.

[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 будет true, если элементы метаданных могут быть добавлены или изменены.

[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().