Класс QMediaObject

Класс QMediaObject предоставляет общий базовый класс для мультимедийных объектов. Подробнее...

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

Свойства

• notifyInterval : int

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

Сигналы

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

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

Он предоставляет некоторые основные функции, общие для других классов высокого уровня, таких как QMediaPlayer, QAudioDecoder и QCamera, включая функциональность доступности и метаданных, а также функции подключения мультимедийных объектов с вспомогательными классами, такими как QMediaPlaylist.

Классы, производные от QMediaObject более высокого уровня, обеспечивают фактическую мультимедийную функциональность, используя внутри QMediaService. Каждый медиа-объект содержит QMediaService и использует интерфейсы QMediaControl, реализованные в службе, для реализации своего API. К этим контроллерам можно получить доступ из медиа-объекта, если это необходимо, но в целом полезная функциональность доступна из классов более высокого уровня.

Большинство медиа-объектов при создании запрашивают новый экземпляр QMediaService, но некоторые, такие как QMediaRecorder и QAudioRecorder, будут совместно использовать службу с другим объектом.

См. также QMediaService и QMediaControl.

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

[protected] QMediaObject::QMediaObject(QObject *parent, QMediaService *service)

Конструирует медиа-объект, который использует функциональность, предоставляемую медиа-службой.

parent передается в QObject.

Этот класс предназначен как базовый класс для мультимедийных объектов, поэтому этот конструктор защищен.

[signal] void QMediaObject::availabilityChanged(QMultimedia::AvailabilityStatus availability)

Сигнал, который генерируется, когда состояние доступности сервиса изменилось на availability.

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

connect(mediaObject, QOverload<QMultimedia::AvailabilityStatus>::of(&QMediaObject::availabilityChanged),
    [=](QMultimedia::AvailabilityStatus availability){ /* ... */ });

[signal] void QMediaObject::availabilityChanged(bool available)

Сигнал, который генерируется, когда состояние доступности изменилось на available.

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

connect(mediaObject, QOverload<bool>::of(&QMediaObject::availabilityChanged),
    [=](bool available){ /* ... */ });

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

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

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

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

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

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

[signal] void QMediaObject::metaDataChanged()

Сигнализирует, что метаданные этого медиа-объекта изменились.

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

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

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

[signal] void QMediaObject::notifyIntervalChanged(int milliseconds)

Сигнал изменения интервала уведомления на milliseconds.

Примечание: Сигнал уведомления для свойства notifyInterval.

[virtual] QMediaObject::~QMediaObject()

Уничтожает этот объект медиаданных.

[protected] void QMediaObject::addPropertyWatch(const QByteArray &name)

Отслеживать свойство name. Сигнал уведомления о свойстве будет испускаться один раз каждые notifyInterval миллисекунд.

См. также notifyInterval.

[virtual] QMultimedia::AvailabilityStatus QMediaObject::availability() const

Возвращает доступность функциональности, предоставляемой этим объектом.

В некоторых случаях функциональность может быть недоступна (например, если текущая операционная система или платформа не предоставляют необходимую функциональность) или временно недоступна (например, воспроизведение аудио во время телефонного звонка или аналогичных действий).

QStringList QMediaObject::availableMetaData() const

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

[virtual] bool QMediaObject::bind(QObject *object)

Связать object с этим экземпляром QMediaObject.

Этот метод устанавливает взаимосвязь между этим объектом медиаданных и вспомогательным объектом. Характер взаимосвязи зависит от обеих сторон. Данный метод возвращает true, если вспомогательный объект был успешно связан, и false в противном случае.

Большинство подклассов QMediaObject предоставляют более удобные функции, которые оборачивают эту функциональность, поэтому эту функцию редко нужно вызывать напрямую.

Передаваемый объект должен реализовывать интерфейс QMediaBindableInterface.

См. также QMediaBindableInterface.

[virtual] bool QMediaObject::isAvailable() const

Возвращает true, если служба доступна для использования.

bool QMediaObject::isMetaDataAvailable() const

Возвращает true, если с этим объектом медиаданных связаны метаданные, иначе false.

QVariant QMediaObject::metaData(const QString &key) const

Возвращает значение, связанное с метаданными key.

См. список предопределенных ключей метаданных.

[protected] void QMediaObject::removePropertyWatch(const QByteArray &name)

Удалить свойство name из списка свойств, изменения которых регулярно сигнализируются.

См. также notifyInterval.

[virtual] QMediaService *QMediaObject::service() const

Возвращает службу мультимедиа, которая предоставляет функциональность этого объекта мультимедиа.

[virtual] void QMediaObject::unbind(QObject *object)

Отключить object от экземпляра QMediaObject.

Отвязать вспомогательный объект от этого объекта медиаданных. Если объект не был ранее привязан к этому объекту, будет выведено предупреждение.

См. также QMediaBindableInterface.