QMediaRecorder Class

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

멤버 함수 문서

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

미디어 레코더를 생성합니다. 이 미디어 레코더는 ` parent`의 자식 객체입니다.

[override virtual noexcept] QMediaRecorder::~QMediaRecorder()

미디어 레코더 객체를 삭제합니다.

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

기록된 미디어의 실제 location 값이 변경되었음을 알리는 신호입니다. 이 신호는 일반적으로 기록이 시작될 때 발생합니다.

void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)

녹화된 미디어에 ‘ metaData ’을 추가합니다.

int QMediaRecorder::audioBitRate() const

압축된 오디오 스트림의 비트 전송률을 초당 비트 단위로 반환합니다.

참조: ` setAudioBitRate()` 함수.

[signal] void QMediaRecorder::audioBitRateChanged()

오디오 녹음 비트 레이트가 변경될 때 신호를 보냅니다.

int QMediaRecorder::audioChannelCount() const

오디오 채널 수를 반환합니다.

setAudioChannelCount()도 참조하십시오 .

[signal] void QMediaRecorder::audioChannelCountChanged()

오디오 녹음 채널 수가 변경될 때 신호를 보냅니다.

int QMediaRecorder::audioSampleRate() const

오디오 샘플 레이트를 Hz 단위로 반환합니다.

setAudioSampleRate()도 참조하십시오 .

[signal] void QMediaRecorder::audioSampleRateChanged()

오디오 녹음 샘플 레이트가 변경될 때 신호를 보냅니다.

QMediaCaptureSession *QMediaRecorder::captureSession() const

미디어 캡처 세션을 반환합니다.

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

기록된 미디어의 duration 속성이 변경되었음을 알리는 신호입니다.

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

인코딩 모드를 반환합니다.

setEncodingMode() 및 EncodingMode도 참조하십시오 .

[signal] void QMediaRecorder::encodingModeChanged()

인코딩 모드가 변경될 때 신호를 보냅니다.

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

error 가 발생했음을 알리는 신호이며, errorString 에 오류에 대한 설명이 포함되어 있습니다.

bool QMediaRecorder::isAvailable() const

미디어 레코더 서비스가 사용 가능한 상태이면 ` true `를 반환합니다.

[signal] void QMediaRecorder::metaDataChanged()

미디어 객체의 메타데이터가 변경되었음을 알립니다.

여러 메타데이터 요소가 변경된 경우 metaDataChanged() 신호가 한 번 발생합니다.

QIODevice *QMediaRecorder::outputDevice() const

미디어 콘텐츠에 대한 출력 IO 장치를 반환합니다.

setOutputDevice()도 참조하십시오 .

[slot] void QMediaRecorder::pause()

녹음을 일시 중지합니다.

레코더 상태가 ' QMediaRecorder::PausedState'으로 변경됩니다.

플랫폼에 따라 녹화 일시 중지가 지원되지 않을 수 있습니다. 이 경우 레코더 상태는 변경되지 않습니다.

[signal] void QMediaRecorder::qualityChanged()

녹화 품질이 변경될 때 신호를 보냅니다.

[slot] void QMediaRecorder::record()

녹화를 시작합니다.

레코더 상태는 즉시 c{QMediaRecorder::RecordingState}로 변경되지만, 녹화는 비동기적으로 시작될 수 있습니다.

녹화가 실패하면 error() 신호가 발송되며, 레코더 상태는 QMediaRecorder::StoppedState 로 재설정됩니다.

이 메서드는 생성 규칙에 따라 actualLocation 를 업데이트합니다.

QMediaRecorder::RecorderState QMediaRecorder::recorderState() const

현재 미디어 레코더의 상태를 반환합니다.

QMediaRecorder::RecorderState도 참조하십시오 .

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

미디어 레코더의 ` state ` 속성이 변경되었음을 알리는 신호입니다.

void QMediaRecorder::setAudioBitRate(int bitRate)

오디오의 비트/초( bitRate ) 값을 설정합니다.

audioBitRate()도 참조하십시오 .

void QMediaRecorder::setAudioChannelCount(int channels)

오디오 channels 의 개수를 설정합니다.

값이 -1인 경우, 레코더는 오디오 소스에서 사용할 수 있는 정보와 코덱의 제한 사항을 바탕으로 최적의 선택을 해야 함을 나타냅니다.

audioChannelCount()도 참조하십시오 .

void QMediaRecorder::setAudioSampleRate(int sampleRate)

오디오 sampleRate 를 Hz 단위로 설정합니다.

-1 값은 레코더가 오디오 소스에서 제공되는 정보와 코덱의 제한 사항을 바탕으로 최적의 선택을 해야 함을 나타냅니다.

audioSampleRate()도 참조하십시오 .

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

인코딩 mode 설정을 지정합니다.

ConstantQualityEncoding 가 설정된 경우 품질 인코딩 매개변수가 사용되고 비트레이트는 무시되며, 그렇지 않은 경우 비트레이트가 사용됩니다.

encodingMode() 및 EncodingMode도 참조하십시오 .

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

메타데이터를 metaData 로 설정합니다.

참조: metaData()

void QMediaRecorder::setOutputDevice(QIODevice *device)

미디어 콘텐츠에 대한 출력 IO 장치를 설정합니다.

녹화가 시작되기 전에 device 가 WriteOnly 또는 ReadWrite 모드로 열려 있어야 합니다.

미디어 레코더는 지정된 device 의 소유권을 가져가지 않습니다. 녹화가 시작된 경우, recorderStateChanged(StoppedState) 신호가 전송될 때까지 해당 장치를 활성 상태로 유지하고 열어두어야 합니다.

이 메서드는 지정된 device 가 null 가 아닌 경우 actualLocation 를 즉시 재설정합니다.

레코더에 쓰기 가능한 출력 장치가 할당된 경우, ` outputLocation `는 무시되며, 녹화가 시작될 때 ` actualLocation `가 생성되지 않습니다. 이 동작은 향후 변경될 수 있으므로, ` outputLocation ` 또는 ` outputDevice` 중 하나만 출력 장치로 설정할 것을 권장합니다.

QMediaRecorder::setOutputDevice 이는 FFmpeg 백엔드에서만 지원됩니다.

outputDevice() 및 outputLocation도 참조하십시오 .

void QMediaRecorder::setVideoBitRate(int bitRate)

bitRate 속성을 초당 비트 단위로 설정합니다.

videoBitRate()도 참조하십시오 .

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

frameRate 의 비디오 인코딩을 설정합니다.

videoFrameRate()도 참조하십시오 .

void QMediaRecorder::setVideoResolution(const QSize &size)

인코딩된 비디오의 해상도를 size 로 설정합니다.

빈 QSize 객체를 전달하면 레코더가 비디오 소스에서 사용할 수 있는 해상도와 코덱의 제한 사항을 바탕으로 최적의 해상도를 선택합니다.

videoResolution()도 참조하십시오 .

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

인코딩된 비디오의 해상도에 대한 ` width ` 및 ` height ` 속성을 설정합니다.

[slot] void QMediaRecorder::stop()

레코더는 녹화를 중지합니다. 다만, 처리 대기 중인 영상 및 오디오 데이터를 처리하는 데는 여전히 시간이 다소 소요될 수 있습니다. 미디어 레코더의 상태가 ‘ QMediaRecorder::StoppedState ’로 변경되면 녹화가 완료됩니다.

int QMediaRecorder::videoBitRate() const

압축된 비디오 스트림의 비트 전송률을 초당 비트 단위로 반환합니다.

참조: ` setVideoBitRate()` 함수.

[signal] void QMediaRecorder::videoBitRateChanged()

녹화 중인 비디오의 비트레이트가 변경될 때 신호를 보냅니다.

qreal QMediaRecorder::videoFrameRate() const

비디오 인코딩 프레임 속도를 반환합니다.

setVideoFrameRate()도 참조하십시오 .

[signal] void QMediaRecorder::videoFrameRateChanged()

비디오 인코딩 프레임 속도가 변경될 때 신호를 보냅니다.

QSize QMediaRecorder::videoResolution() const

인코딩된 동영상의 해상도를 반환합니다.

setVideoResolution()도 참조하십시오 .

[signal] void QMediaRecorder::videoResolutionChanged()

동영상 녹화 해상도가 변경될 때 신호를 보냅니다.