Класс QMediaObject

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

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

Свойства

• notifyInterval : int

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

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

• 32 открытые функции унаследованы от 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)

Создаёт мультимедийный объект, использующий функциональность, предоставляемую службой 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 перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию 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(QByteArray const &name)

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

См. также notifyInterval.

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

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

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

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

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

См. также QMediaBindableInterface.