Класс QMediaRecorder

Класс QMediaRecorder используется для записи медиаконтента. Подробнее...

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

Публичные типы

Свойства

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

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

Переопределённые открытые функции

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

Открытые слоты

• 1 public slot inherited from QObject

Сигналы

• 2 signals inherited from QObject

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

• 11 static public members inherited from QObject
• 9 protected functions inherited from QObject
• 1 protected function inherited from QMediaBindableInterface

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

Класс QMediaRecorder используется для записи медиаконтента.

Класс QMediaRecorder — это высокоуровневый класс для записи медиа. Он не предназначен для самостоятельного использования, а для доступа к функциям записи медиа других медиаобъектов, таких как QRadioTuner или QCamera.

recorder = new QMediaRecorder(camera);

QAudioEncoderSettings audioSettings;
audioSettings.setCodec("audio/amr");
audioSettings.setQuality(QMultimedia::HighQuality);

recorder->setAudioSettings(audioSettings);

recorder->setOutputLocation(QUrl::fromLocalFile(fileName));
recorder->record();

См. также QAudioRecorder.

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

перечисление QMediaRecorder::Error

перечисление QMediaRecorder::State

перечисление QMediaRecorder::Status

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

QMediaRecorder::QMediaRecorder(QMediaObject *mediaObject, QObject *parent = Q_NULLPTR)

Создаёт рекордер медиа, который записывает медиа, произведенное объектом mediaObject.

parent передается объекту QMediaObject.

QMediaRecorder::~QMediaRecorder()

Удаляет объект рекордера медиа.

[signal] void QMediaRecorder::actualLocationChanged(const QUrl &location)

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

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

QString QMediaRecorder::audioCodecDescription(const QString &codec) const

Возвращает описание аудио codec.

QAudioEncoderSettings QMediaRecorder::audioSettings() const

Возвращает настройки аудиокодека, используемые в настоящее время.

См. также setAudioSettings() и setEncodingSettings().

QMultimedia::AvailabilityStatus QMediaRecorder::availability() const

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

См. также availabilityChanged().

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

Сигнализирует о том, что рекордер медиа теперь доступен (если available равно true) или нет.

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

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

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

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

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

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

QStringList QMediaRecorder::availableMetaData() const

Возвращает список ключей, для которых доступны метаданные.

QString QMediaRecorder::containerDescription(const QString &format) const

Возвращает описание контейнера format.

QString QMediaRecorder::containerFormat() const

Возвращает выбранный формат контейнера.

См. также setContainerFormat().

[signal] void QMediaRecorder::durationChanged(qint64 duration)

Сигнализирует о том, что продолжительность записанного медиа изменилась.

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

Error QMediaRecorder::error() const

Возвращает текущее состояние ошибки.

См. также errorString().

[signal] void QMediaRecorder::error(QMediaRecorder::Error error)

Сигнализирует о возникновении ошибки error.

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

connect(mediaRecorder, QOverload<QMediaRecorder::Error>::of(&QMediaRecorder::error),
    [=](QMediaRecorder::Error error){ /* ... */ });

QString QMediaRecorder::errorString() const

Возвращает строку, описывающую текущее состояние ошибки.

См. также error().

bool QMediaRecorder::isAvailable() const

Возвращает true, если служба записи медиа готова к использованию.

См. также availabilityChanged().

[override virtual] QMediaObject *QMediaRecorder::mediaObject() const

Переопределено из QMediaBindableInterface::mediaObject().

Возвращает экземпляр QMediaObject, к которому привязана эта запись QMediaRecorder, или 0 в противном случае.

QVariant QMediaRecorder::metaData(const QString &key) const

Возвращает значение, связанное с метаданными с ключом key.

См. также setMetaData().

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

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

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

[signal] void QMediaRecorder::metaDataChanged()

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

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

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

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

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

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

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

connect(mediaRecorder, QOverload<const QString &, const QVariant &>::of(&QMediaRecorder::metaDataChanged),
    [=](const QString &key, const QVariant &value){ /* ... */ });

[signal] void QMediaRecorder::metaDataWritableChanged(bool writable)

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

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

[signal] void QMediaRecorder::mutedChanged(bool muted)

Сигнализирует о том, что состояние muted изменилось. Если true, запись глушится.

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

[slot] void QMediaRecorder::pause()

Приостановить запись.

Состояние записывающего устройства изменяется на QMediaRecorder::PausedState.

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

[slot] void QMediaRecorder::record()

Начать запись.

Хотя состояние записывающего устройства сразу изменяется на QMediaRecorder::RecordingState, запись может начаться асинхронно, при этом вызывается сигнал statusChanged(QMediaRecorder::RecordingStatus) при начале записи.

Если запись не удается, вызывается сигнал error() с состоянием записывающего устройства, сбрасывающимся обратно на QMediaRecorder::StoppedState.

void QMediaRecorder::setAudioSettings(const QAudioEncoderSettings &settings)

Устанавливает параметры кодировщика звука settings.

Если некоторые параметры не указаны или передан null-указатель, кодировщик выберет параметры кодирования по умолчанию, в зависимости от свойств источника медиа.

Изменение параметров возможно только когда кодировщик находится в состоянии QMediaEncoder::StoppedState.

См. также audioSettings(), videoSettings() и containerFormat().

void QMediaRecorder::setContainerFormat(const QString &container)

Устанавливает формат контейнера медиа container.

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

Изменение параметров возможно только когда кодировщик находится в состоянии QMediaEncoder::StoppedState.

См. также audioSettings(), videoSettings() и containerFormat().

void QMediaRecorder::setEncodingSettings(const QAudioEncoderSettings &audio, const QVideoEncoderSettings &video = QVideoEncoderSettings(), const QString &container = QString())

Устанавливает параметры кодировщика audio и video и формат контейнера container.

Если некоторые параметры не указаны или передан null-указатель, кодировщик выберет параметры кодирования по умолчанию, в зависимости от свойств источника медиа.

Изменение параметров возможно только когда кодировщик находится в состоянии QMediaEncoder::StoppedState.

См. также audioSettings(), videoSettings() и containerFormat().

void QMediaRecorder::setMetaData(const QString &key, const QVariant &value)

Устанавливает значение value для метаданных с ключом key.

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

См. также metaData().

void QMediaRecorder::setVideoSettings(const QVideoEncoderSettings &settings)

Устанавливает параметры видео кодировщика settings.

Если некоторые параметры не указаны или передан null-указатель, кодировщик выберет параметры кодирования по умолчанию, в зависимости от свойств источника медиа.

Изменение параметров возможно только когда кодировщик находится в состоянии QMediaEncoder::StoppedState.

См. также audioSettings(), videoSettings() и containerFormat().

State QMediaRecorder::state() const

Возвращает текущее состояние записывающего устройства.

Примечание: Функция-получатель для свойства state.

См. также QMediaRecorder::State.

[signal] void QMediaRecorder::stateChanged(QMediaRecorder::State state)

Сигнализирует о том, что состояние медиа-регистратора изменилось на state.

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

Status QMediaRecorder::status() const

Возвращает текущий статус медиа-регистратора.

Примечание: Функция-геттер для свойства status.

См. также QMediaRecorder::Status.

[slot] void QMediaRecorder::stop()

Остановить запись.

Состояние регистратора изменяется на QMediaRecorder::StoppedState.

QStringList QMediaRecorder::supportedAudioCodecs() const

Возвращает список поддерживаемых кодеков аудио.

QList<int> QMediaRecorder::supportedAudioSampleRates(const QAudioEncoderSettings &settings = QAudioEncoderSettings(), bool *continuous = Q_NULLPTR) const

Возвращает список поддерживаемых частот дискретизации аудио.

Если в качестве параметра передан ненулевой settings, возвращаемый список сокращается до частот дискретизации, поддерживаемых с частично применёнными настройками.

Это можно использовать для запроса списка частот дискретизации, поддерживаемых конкретным кодеком аудио.

Если кодек поддерживает произвольные частоты дискретизации в пределах поддерживаемого диапазона, *continuous устанавливается в true, в противном случае *continuous устанавливается в false.

QStringList QMediaRecorder::supportedContainers() const

Возвращает список поддерживаемых контейнеров форматов.

QList<qreal> QMediaRecorder::supportedFrameRates(const QVideoEncoderSettings &settings = QVideoEncoderSettings(), bool *continuous = Q_NULLPTR) const

Возвращает список частот кадров, при которых можно кодировать видео.

Если в качестве параметра передан ненулевой settings, возвращаемый список сокращается до частот кадров, поддерживаемых с частично применёнными настройками, такими как кодек видео или разрешение.

Если кодек поддерживает произвольные частоты кадров в поддерживаемом диапазоне, *continuous устанавливается в true, в противном случае *continuous устанавливается в false.

См. также QVideoEncoderSettings::frameRate().

QList<QSize> QMediaRecorder::supportedResolutions(const QVideoEncoderSettings &settings = QVideoEncoderSettings(), bool *continuous = Q_NULLPTR) const

Возвращает список разрешений, при которых можно кодировать видео.

Если в качестве параметра передан ненулевой settings, возвращаемый список сокращается до разрешений, поддерживаемых с частично применёнными настройками, такими как кодек видео или частота кадров.

Если кодек поддерживает произвольные разрешения в поддерживаемом диапазоне, *continuous устанавливается в true, в противном случае *continuous устанавливается в false.

См. также QVideoEncoderSettings::resolution().

QStringList QMediaRecorder::supportedVideoCodecs() const

Возвращает список поддерживаемых кодеков видео.

QString QMediaRecorder::videoCodecDescription(const QString &codec) const

Возвращает описание кодека видео codec.

См. также setEncodingSettings().

QVideoEncoderSettings QMediaRecorder::videoSettings() const

Возвращает настройки кодера видео, используемые в данный момент.

См. также setVideoSettings() и setEncodingSettings().