Класс QMediaRecorder

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

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

Общедоступные типы

Свойства

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

Публичные функции

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

• 31 публичная функция унаследована от QObject
• 1 публичная функция унаследована от QMediaBindableInterface

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

• 1 public slot inherited from QObject

Сигналы

• 2 signals inherited from QObject

Статические публичные члены

• 9 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 = nullptr)

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

parent передается в QMediaObject.

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

QMediaRecorder::Error QMediaRecorder::error() const

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

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

[signal] void QMediaRecorder::error(QMediaRecorder::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) отправляется для каждого из них, а сигнал 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)

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

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

[signal] void QMediaRecorder::mutedChanged(bool 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.

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

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

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

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

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

QMediaRecorder::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 = 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().