Класс QMediaRecorder

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

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

Открытые типы

Свойства

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

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

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

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

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

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

Сигналы

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

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

• 11 статических public членов унаследованы от QObject
• 9 protected функций унаследованы от QObject
• 1 protected функция унаследована от 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 перегружен в этом классе. Для подключения к этому сигналу с использованием синтаксиса указателя на функцию необходимо указать тип сигнала в статическом преобразовании, как показано в данном примере:

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

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

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

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

connect(mediaRecorder, static_cast<void(QMediaRecorder::*)(QMultimedia::AvailabilityStatus)>(&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.

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

Error QMediaRecorder::error() const

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

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

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

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

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

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

QString QMediaRecorder::errorString() const

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

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

bool QMediaRecorder::isAvailable() const

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

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

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

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

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

[signal] void QMediaRecorder::metaDataChanged()

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

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

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

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

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

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

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

connect(mediaRecorder, static_cast<void(QMediaRecorder::*)(const QString &, const QVariant &)>(&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, в противном случае — в false.

QStringList QMediaRecorder::supportedContainers() const

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

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

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

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

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

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

QList<QSize> QMediaRecorder::supportedResolutions(const QVideoEncoderSettings &settings = QVideoEncoderSettings(), bool *continuous = Q_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().