QAudioSink Class

QFile sourceFile; // 클래스 멤버.QAudioSink* audio; // 클래스 멤버.{ sourceFile.setFileName("/tmp/test.raw"); sourceFile.open(QIODevice::읽기 전용);    QAudioFormat format; // 포맷 설정, 예: format.setSampleRate(8000); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::UInt8);    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;
}

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

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

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

멤버 함수 문서

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

새 오디오 출력을 생성하고 parent 에 첨부합니다. 기본 오디오 출력 장치는 출력 format 매개변수와 함께 사용됩니다.

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

새 오디오 출력을 구성하고 parent 에 첨부합니다. audioDevice 에서 참조하는 장치는 출력 format 매개변수와 함께 사용됩니다.

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

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

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

qsizetype QAudioSink::bufferSize() const

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

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

setBufferSize()도 참조하세요 .

qsizetype QAudioSink::bytesFree() const

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

qint64 QAudioSink::elapsedUSecs() const

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

QtAudio::Error QAudioSink::error() const

오류 상태를 반환합니다.

QAudioFormat QAudioSink::format() const

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

bool QAudioSink::isNull() const

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

qint64 QAudioSink::processedUSecs() const

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

void QAudioSink::reset()

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

stop()도 참조하세요 .

void QAudioSink::resume()

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

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

void QAudioSink::setBufferSize(qsizetype value)

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

bufferSize()도 참조하세요 .

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 를참조하세요 .

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 를참조하세요 .

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

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

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

qreal QAudioSink::volume() const

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

setVolume()도 참조하세요 .