QMediaRecorder Class

QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&input);
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 가 변경되었음을 알리는 신호입니다.

[signal] void QMediaRecorder::encoderSettingsChanged()

인코더 설정이 변경되면 신호를 보냅니다.

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

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

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

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 장치를 설정합니다.

녹화를 시작하기 전에 WriteOnly 또는 ReadWrite 모드에서 device 을 열어야 합니다.

미디어 레코더는 지정된 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.

값이 0이면 레코더가 비디오 소스에서 사용할 수 있는 항목과 코덱의 제한 사항에 따라 최적의 선택을 해야 함을 나타냅니다.

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

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