Класс QMediaObject

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

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

Свойства

• notifyInterval : int

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

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

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

Сигналы

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

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

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

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

• 1 открытый слот унаследован от QObject
• 11 статических открытых членов унаследовано от QObject

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

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

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

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

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

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

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

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

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

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

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

QMediaObject::~QMediaObject()

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

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

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

См. также notifyInterval.

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

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

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

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

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

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

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

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

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

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

connect(mediaObject, static_cast<void(QMediaObject::*)(QMultimedia::AvailabilityStatus)>(&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 перегружен в этом классе. Чтобы подключиться к нему с помощью синтаксиса указателя на функцию, необходимо указать тип сигнала в статическом приведении, как показано в этом примере:

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

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

Сигнализирует об изменениях одного элемента метаданных value с заданным key.

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

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

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

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

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

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

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

См. также notifyInterval.

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

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

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

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

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

См. также QMediaBindableInterface.