Класс 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 с заданным key.

Примечание: Сигнал 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.