Класс QMediaObject

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

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

Свойства

• notifyInterval : int

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

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

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

Сигналы

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

Статические открытые члены

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

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

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

Защищенные переменные

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

• 1 открытый слот унаследован от 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.