QAudioSink Class

QFile sourceFile; // 클래스 멤버.QAudioSink* audio; // 클래스 멤버.{ sourceFile.setFileName("/tmp/test.raw"); sourceFile.open(QIODevice::읽기 전용);    QAudioFormat format; // 포맷 설정, 예: format.setSampleRate(44100); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::Int16);    QAudioDevice 정보(QMediaDevices::defaultAudioOutput()); if (!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
       return; } audio = new QAudioSink(format, this); connect(audio, QAudioSink::stateChanged, this, &AudioInputExample::handleStateChanged);  audio->start(&sourceFile); }

void AudioOutputExample::stopAudioOutput()
{
    audio->stop();
    sourceFile.close();
    delete audio;
}

QAudioSink* audio; // 클래스 멤버.float phase; // 클래스 멤버{ .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 play audio.";
       return; } audio = new QAudioSink(format, this); float phaseIncrement = 2 * M_PI * 220.0 / format.sampleRate(); // 220Hz 사인파 audio->start([&phase, phaseIncrement] (QSpan<플로트> 인터리브 오디오 버퍼) { // 오디오 콜백은 잠재적으로 차단할 수 있는 함수를 호출하지 않아야  합니다 // 사인파로 오디오 버퍼를 채웁니다 const int sampleCount = interleavedAudioBuffer.size() / 2; // 스테레오, 그래서 2로 나누기 for(int i = 0; i < sampleCount; ++i) { float sample = std::sin(phase); interleavedAudioBuffer[i * 2] = sample; // 왼쪽 채널interleavedAudioBuffer[i * 2 + 1] = sample; // 오른쪽 채널phase += phaseIncrement; // 다음 샘플의 위상 증가} }); if (!audio->error()== QtAudio::Error::NoError) { // 다른 start() 시그니처와 더불어, // 백엔드가 콜백 기반 IO를 구현하지 않는  경우 오디오 콜백 시작은 실패합니다 (API는 모든 주요 // 플랫폼에서  사용 가능 ) // * 오디오 콜백의 시그니처가 format.sampleFormat()와 일치하지  않습니다 .
        qWarning() << "Error starting audio output:" << audio->errorString();
    } }

void AudioOutputExample::handleStateChanged(QtAudio::State newState)
{
    switch (newState) {
        case QtAudio::IdleState:
            // Finished playing (no more data)
            AudioOutputExample::stopAudioOutput();
            break;

        case QtAudio::StoppedState:
            // Stopped for other reasons
            if (audio->error() != QtAudio::NoError) {
                // Error handling
            }
            break;

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

멤버 함수 문서

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

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

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

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

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

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

이렇게 하면 사용된 모든 시스템 리소스가 해제되고 버퍼가 해제됩니다.

[since 6.10] qsizetype QAudioSink::bufferFrameCount() const

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

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

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

setBufferFrameCount() 와 bufferSize도 참조하십시오 .

qsizetype QAudioSink::bufferSize() const

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

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

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

qsizetype QAudioSink::bytesFree() const

오디오 버퍼에서 사용 가능한 여유 바이트 수를 반환합니다.

framesFree도 참조하세요 .

qint64 QAudioSink::elapsedUSecs() const

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

QtAudio::Error QAudioSink::error() const

오류 상태를 반환합니다.

QAudioFormat QAudioSink::format() const

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

[since 6.10] qsizetype QAudioSink::framesFree() const

오디오 버퍼에서 사용 가능한 여유 프레임 수를 반환합니다.

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

bytesFree 를참조하세요 .

bool QAudioSink::isNull() const

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

qint64 QAudioSink::processedUSecs() const

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

void QAudioSink::reset()

오디오 출력을 즉시 중단하고 현재 버퍼에 있는 모든 오디오 데이터를 삭제합니다. QIODevice 으로 푸시된 모든 보류 중인 오디오 데이터는 무시됩니다.

stop()도 참조하세요 .

void QAudioSink::resume()

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

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

[since 6.10] void QAudioSink::setBufferFrameCount(qsizetype value)

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

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

bufferFrameCount() 및 setBufferSize 을참조하십시오 .

void QAudioSink::setBufferSize(qsizetype value)

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

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

void QAudioSink::setVolume(qreal volume)

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

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

기본 볼륨은 1.0 입니다.

UI 볼륨 컨트롤은 일반적으로 비선형적으로 조절해야 합니다. 예를 들어 로그 스케일을 사용하면 사용자가 일반적으로 볼륨 컨트롤에서 기대할 수 있는 선형적인 음량 변화가 발생합니다. 자세한 내용은 QtAudio::convertVolume()를 참조하세요.

volume()도 참조하세요 .

QIODevice *QAudioSink::start()

시스템의 오디오 출력으로 데이터를 전송하는 데 사용되는 내부 QIODevice 에 대한 포인터를 반환합니다. 장치가 이미 열려 있고 write()가 여기에 직접 데이터를 쓸 수 있습니다.

QAudioSink 가 시스템의 오디오 장치에 액세스할 수 있는 경우 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_sink_callback<Callback> = true> void QAudioSink::start(Callback &&cb)

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

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

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

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

Callback interface 를참조하세요 .

void QAudioSink::start(QIODevice *device)

device 에서 시스템의 오디오 출력으로 오디오 데이터 전송을 시작합니다. ReadOnly 또는 ReadWrite 모드에서 device 을 열어야 합니다.

QAudioSink 가 오디오 데이터를 성공적으로 출력할 수 있으면 state()는 QtAudio::ActiveState, error()는 QtAudio::NoError 를 반환하고 stateChanged() 신호가 방출됩니다.

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

QIODevice 및 QIODevice interface 을참조하세요 .

QtAudio::State QAudioSink::state() const

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

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

이 신호는 장치 state 가 변경되었을 때 방출됩니다. 오디오 출력의 현재 상태입니다.

void QAudioSink::stop()

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

error()를 QtAudio::NoError, state()를 QtAudio::StoppedState 으로 설정하고 stateChanged() 신호를 내보냅니다.

reset()도 참조하세요 .

void QAudioSink::suspend()

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

state()를 QtAudio::SuspendedState 로 설정하고 stateChanged() 신호를 내보냅니다.

qreal QAudioSink::volume() const

0.0에서 1.0 사이의 볼륨을 반환합니다.

setVolume()도 참조하세요 .