Класс QMediaRecorder

Класс 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 = nullptr)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сигнализирует об изменении duration записанного медиа.

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

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

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

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

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

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

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

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

[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::metaDataChanged()

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

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

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

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

[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.

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

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

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

[slot] void QMediaRecorder::stop()

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

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

[virtual] QMediaRecorder::~QMediaRecorder()

Уничтожает объект рекордера медиа.

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

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

QAudioEncoderSettings QMediaRecorder::audioSettings() const

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

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

QMultimedia::AvailabilityStatus QMediaRecorder::availability() const

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

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

QStringList QMediaRecorder::availableMetaData() const

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

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

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

QString QMediaRecorder::containerFormat() const

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

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

QMediaRecorder::Error QMediaRecorder::error() const

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

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

QString QMediaRecorder::errorString() const

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

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

bool QMediaRecorder::isAvailable() const

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

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

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

Переопределяет: QMediaBindableInterface::mediaObject() const.

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

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

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

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

void QMediaRecorder::setAudioSettings(const QAudioEncoderSettings &settings)

Устанавливает настройки кодировщика аудио settings.

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

Изменение настроек возможно только когда кодировщик находится в состоянии 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.

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

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

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

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

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

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

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

void QMediaRecorder::setVideoSettings(const QVideoEncoderSettings &settings)

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

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

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

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

QMediaRecorder::State QMediaRecorder::state() const

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

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

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

QMediaRecorder::Status QMediaRecorder::status() const

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

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

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

QStringList QMediaRecorder::supportedAudioCodecs() const

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

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

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

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

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

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

QStringList QMediaRecorder::supportedContainers() const

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

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

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

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

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

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

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

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

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

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

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

QStringList QMediaRecorder::supportedVideoCodecs() const

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

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

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

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

QVideoEncoderSettings QMediaRecorder::videoSettings() const

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

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