QAudioSource Class

QFile destinationFile; // 클래스 멤버QAudioSource* audio; // 클래스 멤버{ destinationFile.setFileName("/tmp/test.raw"); destinationFile.open( QIODevice::WriteOnly | QIODevice::Truncate );  QAudioFormat format; // 원하는 포맷 설정, 예:format.setSampleRate(44100); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::Int16);    QAudioDevice 정보 = QMediaDevices::defaultAudioInput(); if (!info.isFormatSupported(format)) {        qWarning() << "Default format not supported, trying to use the nearest.";
    } audio = new QAudioSource(format, this); connect(audio, &.QAudioSource::stateChanged, this, &AudioInputExample::handleStateChanged);    QTimer::singleShot(3000, this, &AudioInputExample::stopRecording);  audio->start(&destinationFile); // 3000ms 동안 오디오 녹음}

void AudioInputExample::stopRecording()
{
    audio->stop();
    destinationFile.close();
    delete audio;
}

QAudioSource* audio; // 클래스 멤버.std::atomic<float> peakLevel; // 클래스 멤버{ .QAudioFormat format; // 포맷 설정, 예: format.setSampleRate(44100); format.setChannelCount(2); format.setSampleFormat(QAudioFormat::Float);    QAudioDevice 정보(QMediaDevices::defaultAudioOutput()); if (!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot capture audio.";
       return; } audio = new QAudioSource(format, this);  audio->start([&peakLevel] (QSpan<플로트> interleavedAudioBuffer) { float level = peakLevel.load(); for(float sample : interleavedAudioBuffer) { // 오디오 샘플에서 피크 레벨 계산level = std::max(level, std::abs(sample)); } peakLevel.store(level); // 참고: 애플리케이션 스레드에 알림을 주어야 하는 경우  오디오 콜백이 잠재적으로 차단 가능한 시스템 호출을 사용하지 않아야  하기 때문에 주의가 필요합니다.
        //  좋은 옵션은 자동 설정 이벤트(윈도우), eventfd(리눅스), 또는 macos의 kqueue/EVFILT_USER입니다.}); if (!audio->error()== QtAudio::Error::NoError) { // 다른 start() 서명 외에도, // * 백엔드가 콜백 기반 IO를 구현하지 않는  경우 (API는 모든 주요  플랫폼에서  사용 가능 ) // * audio callback의 서명이 format.sampleFormat()과 일치하지 않으면 오디오 콜백  시작은 실패합니다.
        qWarning() << "Error starting audio output:" << audio->errorString();
    } }

void AudioInputExample::handleStateChanged(QtAudio::State newState)
{
    switch (newState) {
        case QtAudio::StoppedState:
            if (audio->error() != QtAudio::NoError) {
                // Error handling
            } else {
                // Finished recording
            }
            break;

        case QtAudio::ActiveState:
            // Started recording - read from IO device
            break;

        default:
            // ... other cases as appropriate
            break;
    }
}

멤버 함수 문서

[explicit] QAudioSource::QAudioSource(const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

새 오디오 입력을 생성하고 parent 에 연결합니다. 기본 오디오 입력 장치는 출력 format 매개변수와 함께 사용됩니다. format 이 기본 초기화되어 있으면 오디오 장치의 기본 형식으로 설정됩니다.

[explicit] QAudioSource::QAudioSource(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

새 오디오 입력을 생성하여 parent 에 연결합니다. audioDevice 에서 참조하는 장치는 format 매개변수와 함께 사용됩니다. format 이 기본 초기화되어 있으면 형식은 기본 형식인 audioDevice 으로 설정됩니다.

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

이 오디오 입력을 삭제합니다.

qsizetype QAudioSource::bufferFrameCount() const

오디오 버퍼 크기를 프레임 단위로 반환합니다.

start() 이전에 호출되면 플랫폼 기본값을 반환합니다. start() 이전에 setBufferSize() 또는 setBufferFrameCount() 가 호출된 경우 setBufferSize() 또는 setBufferFrameCount() 에서 설정한 값을 반환합니다. start() 이후에 호출된 경우 사용 중인 실제 버퍼 크기를 반환합니다. 이 값은 setBufferSize() 또는 setBufferFrameCount() 에서 이전에 설정한 값과 다를 수 있습니다.

setBufferFrameCount() 및 bufferSize도 참조하세요 .

[since 6.10] qsizetype QAudioSource::bufferSize() const

오디오 버퍼 크기를 바이트 단위로 반환합니다.

start() 이전에 호출되면 플랫폼 기본값을 반환합니다. start() 이전에 setBufferSize() 또는 setBufferFrameCount() 가 호출된 경우 setBufferSize() 또는 setBufferFrameCount() 에서 설정한 값을 반환합니다. start() 이후에 호출된 경우 사용 중인 실제 버퍼 크기를 반환합니다. 이 값은 이전에 setBufferSize() 또는 setBufferFrameCount() 에서 설정한 것과 다를 수 있습니다.

이 함수는 Qt 6.10에 도입되었습니다.

setBufferSize() 와 bufferFrameCount도 참조하십시오 .

qsizetype QAudioSource::bytesAvailable() const

읽을 수 있는 오디오 데이터의 양을 바이트 단위로 반환합니다.

framesAvailable도 참조하세요 .

qint64 QAudioSource::elapsedUSecs() const

유휴 및 일시 중단 상태의 시간을 포함하여 start()가 호출된 이후의 마이크로초를 반환합니다.

QtAudio::Error QAudioSource::error() const

오류 상태를 반환합니다.

QAudioFormat QAudioSource::format() const

사용 중인 QAudioFormat 을 반환합니다.

[since 6.10] qsizetype QAudioSource::framesAvailable() const

프레임 단위로 읽을 수 있는 오디오 데이터의 양을 반환합니다.

참고: 반환된 값은 QtAudio::ActiveState 또는 QtAudio::IdleState 상태일 때만 유효하며, 그렇지 않으면 0을 반환합니다.

이 함수는 Qt 6.10에 도입되었습니다.

bytesAvailable 를참조하세요 .

bool QAudioSource::isNull() const

오디오 소스가 null 인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

qint64 QAudioSource::processedUSecs() const

start()가 호출된 이후 처리된 오디오 데이터의 양을 마이크로초 단위로 반환합니다.

void QAudioSource::reset()

버퍼의 모든 오디오 데이터를 삭제하고 버퍼를 0으로 초기화합니다.

void QAudioSource::resume()

suspend() 이후 오디오 데이터 처리를 재개합니다.

state()를 suspend()가 호출되었을 때 싱크의 상태로 설정합니다. 오디오 싱크의 상태가 QtAudio::SuspendedState 이 아닌 경우 이 함수는 아무 작업도 수행하지 않습니다.

void QAudioSource::setBufferFrameCount(qsizetype value)

오디오 버퍼 크기를 프레임 수( value )로 설정합니다.

bufferFrameCount() 및 setBufferSize도 참조하세요 .

[since 6.10] void QAudioSource::setBufferSize(qsizetype value)

오디오 버퍼 크기를 value 바이트로 설정합니다.

이 함수는 Qt 6.10에 도입되었습니다.

bufferSize() 및 setBufferFrameCount 을참조하십시오 .

void QAudioSource::setVolume(qreal volume)

입력 볼륨을 volume 으로 설정합니다.

볼륨은 0.0 (무음)에서 1.0 (최대 볼륨)까지 선형적으로 조절됩니다. 이 범위를 벗어나는 값은 고정됩니다.

장치가 입력 볼륨 조정을 지원하지 않는 경우 volume 은 무시되고 입력 볼륨은 1.0으로 유지됩니다.

기본 볼륨은 1.0 입니다.

volume()도 참조하세요 .

QIODevice *QAudioSource::start()

시스템의 오디오 입력에서 데이터를 전송하는 데 사용되는 내부 QIODevice 에 대한 포인터를 반환합니다. 장치가 이미 열려 있고 read()가 이 장치에서 직접 데이터를 읽을 수 있습니다.

QAudioSource 가 시스템의 오디오 장치에 액세스할 수 있는 경우 state()는 QtAudio::IdleState, error()는 QtAudio::NoError 를 반환하고 stateChanged() 신호가 방출됩니다.

이 프로세스 중에 문제가 발생하면 error()는 QtAudio::OpenError, state()는 QtAudio::StoppedState 을 반환하고 stateChanged() 신호가 전송됩니다.

QIODevice 및 QIODevice interface 을참조하세요 .

[since 6.11] template <typename Callback, QtAudio::if_audio_source_callback<Callback> = true> void QAudioSource::start(Callback &&cb)

소프트-실시간 오디오 스레드에서 호출될 콜백 함수로 QAudioSource 을 시작합니다. 콜백은 QSpan<const SampleType>을 인수로 받는 콜러블이며, SampleType은 QAudioSource 의 형식 중 QAudioFormat::SampleFormat 과 일치해야 합니다. 스팬에는 인터리빙된 오디오 데이터가 포함됩니다.

QAudioSource 를 성공적으로 시작할 수 있으면 error()는 QtAudio::NoError 를 반환합니다.

이 과정에서 문제가 발생하면 error()는 QtAudio::OpenError, state()는 QtAudio::StoppedState 을 반환하고 stateChanged() 신호가 전송됩니다.

이 기능은 Qt 6.11에 도입되었습니다.

Callback interface 를참조하세요 .

void QAudioSource::start(QIODevice *device)

시스템의 오디오 입력에서 device 로 오디오 데이터 전송을 시작합니다. device 은 WriteOnly, Append 또는 ReadWrite 모드에서 열려 있어야 합니다.

QAudioSource 에서 오디오 데이터를 성공적으로 가져올 수 있으면 state()은 QtAudio::ActiveState 또는 QtAudio::IdleState 을 반환하고, error()은 QtAudio::NoError 을 반환하며, stateChanged() 신호가 방출됩니다.

이 과정에서 문제가 발생하면 error()는 QtAudio::OpenError, state()는 QtAudio::StoppedState 을 반환하고 stateChanged() 신호가 전송됩니다.

QIODevice 및 QIODevice interface 을참조하세요 .

QtAudio::State QAudioSource::state() const

오디오 처리 상태를 반환합니다.

[signal] void QAudioSource::stateChanged(QtAudio::State state)

이 신호는 state 장치가 변경되었을 때 방출됩니다.

void QAudioSource::stop()

오디오 입력을 중지하고 시스템 리소스에서 분리합니다.

error()를 QtAudio::NoError, state()를 QtAudio::StoppedState 으로 설정하고 stateChanged() 신호를 방출합니다.

void QAudioSource::suspend()

오디오 데이터 처리를 중지하여 버퍼링된 오디오 데이터를 보존합니다.

error()를 QtAudio::NoError, state()를 QtAudio::SuspendedState 으로 설정하고 stateChanged() 신호를 방출합니다.

qreal QAudioSource::volume() const

입력 볼륨을 반환합니다.

장치가 입력 볼륨 조정을 지원하지 않는 경우 반환되는 값은 1.0이 됩니다.

setVolume()도 참조하세요 .