Класс QMediaRecorder

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

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

Типы публичного доступа

Свойства

• actualLocation : const QUrl
• duration : const qint64
• outputLocation : QUrl
• recorderState : const QMediaRecorder::RecorderState

Функции публичного доступа

Публичные слоты

Сигналы

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

Класс QMediaRecorder — это класс для кодирования и записи медиаданных, созданных в QMediaCaptureSession.

QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&input);
QMediaRecorder recorder;
session.setMediaRecorder(&recorder);
recorder.setQuality(QMediaRecorder::HighQuality);
recorder.setOutputLocation(QUrl::fromLocalFile("test.mp3"));
recorder.record();

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

Перечисление QMediaRecorder::EncodingMode

Перечисляет режимы кодирования.

enum QMediaRecorder::Error

enum QMediaRecorder::Quality

Перечисляет уровни кодирования качества.

enum QMediaRecorder::RecorderState

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

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

Создает рекордер медиа, который записывает медиа, созданное микрофоном и камерой. Рекордер медиа является дочерним элементом parent.

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

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

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

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

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

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

[signal] void QMediaRecorder::errorOccurred(QMediaRecorder::Error error, const QString &errorString)

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

[signal] void QMediaRecorder::metaDataChanged()

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

Если несколько элементов метаданных изменены, metaDataChanged() излучается один раз.

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

[slot] void QMediaRecorder::pause()

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

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

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

[slot] void QMediaRecorder::record()

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

Хотя состояние рекордера сразу же изменяется на QMediaRecorder::RecordingState, запись может начаться асинхронно.

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

[signal] void QMediaRecorder::recorderStateChanged(QMediaRecorder::RecorderState state)

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

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

[slot] void QMediaRecorder::stop()

Останавливает запись.

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

[virtual] QMediaRecorder::~QMediaRecorder()

Уничтожает объект записывающего устройства медиа.

int QMediaRecorder::audioBitRate() const

Возвращает битрейт сжатого аудиопотока в битах в секунду.

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

int QMediaRecorder::audioChannelCount() const

Возвращает количество аудиоканалов.

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

int QMediaRecorder::audioSampleRate() const

Возвращает частоту дискретизации аудио в Гц.

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

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

Возвращает режим кодирования.

См. также setEncodingMode() и EncodingMode.

QMediaRecorder::Error QMediaRecorder::error() const

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

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

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

QString QMediaRecorder::errorString() const

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

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

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

bool QMediaRecorder::isAvailable() const

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

QMediaMetaData QMediaRecorder::metaData() const

Возвращает metaData, связанную с записью.

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

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

QMediaRecorder::RecorderState QMediaRecorder::recorderState() const

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

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

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

void QMediaRecorder::setAudioBitRate(int bitRate)

Устанавливает аудио bitRate в битах в секунду.

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

void QMediaRecorder::setAudioChannelCount(int channels)

Устанавливает количество аудио channels.

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

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

void QMediaRecorder::setAudioSampleRate(int sampleRate)

Устанавливает аудио sampleRate в Гц.

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

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

void QMediaRecorder::setEncodingMode(QMediaRecorder::EncodingMode mode)

Устанавливает настройку режима кодирования mode.

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

См. также encodingMode() и EncodingMode.

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

Устанавливает метаданные в metaData.

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

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

void QMediaRecorder::setVideoBitRate(int bitRate)

Устанавливает видео bitRate в битах в секунду.

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

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

Устанавливает видео frameRate.

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

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

void QMediaRecorder::setVideoResolution(const QSize &size)

Устанавливает разрешение кодированного видео на size.

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

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

void QMediaRecorder::setVideoResolution(int width, int height)

Устанавливает width и height разрешения кодированного видео.

Это перегруженная функция.

int QMediaRecorder::videoBitRate() const

Возвращает битрейт сжатого видеопотока в битах в секунду.

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

qreal QMediaRecorder::videoFrameRate() const

Возвращает частоту кадров видео.

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

QSize QMediaRecorder::videoResolution() const

Возвращает разрешение кодированного видео.

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