Класс QMediaObject

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

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

Свойства

• notifyInterval : int

• 1 свойство унаследовано от QObject

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

• 34 открытых функции унаследованы от QObject

Сигналы

• 2 сигнала унаследованы от QObject

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

• 9 защищенных функций унаследованы от QObject

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QObject
• 1 открытая переменная унаследована от QObject
• 10 статические открытые члены унаследованы от QObject
• 2 защищенные переменные унаследованы от QObject

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

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

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

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

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

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

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

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

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

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

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

[virtual] QMediaObject::~QMediaObject()

Уничтожает этот объект мультимедиа.

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

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

См. также notifyInterval.

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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

[signal] void QMediaObject::metaDataChanged()

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

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

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

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

[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::notifyIntervalChanged(int milliseconds)

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

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

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

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

См. также notifyInterval.

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

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

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

Отсоединяет object от экземпляра QMediaObject.

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

См. также QMediaBindableInterface.