QAudioSink Class

QFile sourceFile; // class member.QAudioSink* audio; // Klassenmitglied.{ sourceFile.setFileName("/tmp/test.raw"); sourceFile.open(QIODevice::ReadOnly);    QAudioFormat format; // Einrichten des Formats, z. B.format.setSampleRate(44100); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::Int16);    QAudioDevice info(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; // Klassenmitglied.float phase; // Klassenmitglied.{ QAudioFormat format; // Einrichten des Formats, z.B.format.setSampleRate(44100); format.setChannelCount(2); format.setSampleFormat(QAudioFormat::Float);    QAudioDevice info(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(); // 220 Hz Sinuswelle audio->start([&phase, phaseIncrement] (QSpan<float> interleavedAudioBuffer) { // Der Audio-Callback sollte keine Funktionen aufrufen, die möglicherweise blockieren könnten // Füllen Sie den Audiopuffer mit einer Sinuswelle const int sampleCount = interleavedAudioBuffer.size() / 2; // Stereo, also durch 2 teilen for(int i = 0; i < sampleCount;++i) { float sample = std::sin(phase); interleavedAudioBuffer[i * 2] = sample; // Linker KanalinterleavedAudioBuffer[i * 2 + 1] = sample; // Rechter Kanalphase += phaseIncrement; // Phase für nächstes Sample erhöhen} }); if (!audio->error() == QtAudio::Error::NoError) { // zusätzlich zu den anderen start()-Signaturen schlägt der Start des Audio-Callbacks fehl, wenn // * das Backend kein callback-basiertes IO implementiert (die API ist auf allen wichtigen // Plattformen  verfügbar ) // * die Signatur des Audio-Callbacks nicht mit format.sampleFormat() übereinstimmt
        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;
    }
}

Dokumentation der Mitgliederfunktionen

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

Konstruieren Sie einen neuen Audioausgang und verbinden Sie ihn mit parent. Das Standard-Audioausgabegerät wird mit den Parametern der Ausgabe format verwendet. Wenn format standardmäßig initialisiert ist, wird das Format auf das bevorzugte Format des Audiogeräts gesetzt.

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

Konstruieren Sie einen neuen Audioausgang und verbinden Sie ihn mit parent. Das Gerät, auf das audioDevice verweist, wird mit den Parametern des Ausgangs format verwendet. Wenn format standardmäßig initialisiert ist, wird das Format auf das bevorzugte Format von audioDevice gesetzt.

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

Zerstört diesen Audioausgang.

Dadurch werden alle verwendeten Systemressourcen und Puffer freigegeben.

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

Gibt die Größe des Audiopuffers in Frames zurück.

Wenn vor start() aufgerufen, wird der Standardwert der Plattform zurückgegeben. Wenn vor start() aufgerufen, aber setBufferSize() oder setBufferFrameCount() vorher aufgerufen wurde, wird der Wert zurückgegeben, der durch setBufferSize() oder setBufferFrameCount() festgelegt wurde. Wenn nach start() aufgerufen, wird die tatsächliche Puffergröße zurückgegeben, die verwendet wird. Diese darf nicht diejenige sein, die zuvor durch setBufferSize() oder setBufferFrameCount() gesetzt wurde.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch setBufferFrameCount() und bufferSize.

qsizetype QAudioSink::bufferSize() const

Gibt die Größe des Audiopuffers in Bytes zurück.

Wenn vor start() aufgerufen, wird der Standardwert der Plattform zurückgegeben. Wenn vor start() aufgerufen, aber setBufferSize() oder setBufferFrameCount() vorher aufgerufen wurde, wird der Wert zurückgegeben, der durch setBufferSize() oder setBufferFrameCount() festgelegt wurde. Wenn nach start() aufgerufen, wird die tatsächliche Puffergröße zurückgegeben, die verwendet wird. Diese darf nicht diejenige sein, die zuvor durch setBufferSize() oder setBufferFrameCount() gesetzt wurde.

Siehe auch setBufferSize() und bufferFrameCount.

qsizetype QAudioSink::bytesFree() const

Gibt die Anzahl der im Audiopuffer verfügbaren freien Bytes zurück.

Siehe auch framesFree.

qint64 QAudioSink::elapsedUSecs() const

Gibt die Mikrosekunden seit dem Aufruf von start() zurück, einschließlich der Zeit im Leerlauf und im Suspend-Zustand.

QtAudio::Error QAudioSink::error() const

Gibt den Fehlerstatus zurück.

QAudioFormat QAudioSink::format() const

Gibt die QAudioFormat zurück, die verwendet wird.

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

Gibt die Anzahl der freien Frames zurück, die im Audiopuffer verfügbar sind.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch bytesFree.

bool QAudioSink::isNull() const

Gibt true zurück, wenn die Instanz QAudioSink null ist, andernfalls gibt sie false zurück.

qint64 QAudioSink::processedUSecs() const

Gibt die Menge der verarbeiteten Audiodaten seit dem Aufruf von start() zurück (in Mikrosekunden).

void QAudioSink::reset()

Stoppt sofort die Audioausgabe und verwirft alle Audiodaten, die sich derzeit in den Puffern befinden. Alle anstehenden Audiodaten, die an QIODevice gesendet werden, werden ignoriert.

Siehe auch stop().

void QAudioSink::resume()

Setzt die Verarbeitung von Audiodaten nach einem suspend() fort.

Setzt state() auf den Zustand, den die Senke hatte, als suspend() aufgerufen wurde. Diese Funktion ist wirkungslos, wenn der Zustand der Audiosenke nicht QtAudio::SuspendedState ist.

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

Setzt die Größe des Audiopuffers auf value in Frame Count.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch bufferFrameCount() und setBufferSize.

void QAudioSink::setBufferSize(qsizetype value)

Setzt die Größe des Audiopuffers auf value in Bytes.

Siehe auch bufferSize() und setBufferFrameCount.

void QAudioSink::setVolume(qreal volume)

Setzt die Ausgabelautstärke auf volume.

Die Lautstärke wird linear von 0.0 (Stille) bis 1.0 (volle Lautstärke) skaliert. Werte, die außerhalb dieses Bereichs liegen, werden geklammert.

Die Standardlautstärke ist 1.0.

Die Lautstärkeregler der Benutzeroberfläche sollten normalerweise nicht linear skaliert werden. Die Verwendung einer logarithmischen Skala führt beispielsweise zu linearen Änderungen der wahrgenommenen Lautstärke, was ein Benutzer normalerweise von einem Lautstärkeregler erwarten würde. Siehe QtAudio::convertVolume() für weitere Einzelheiten.

Siehe auch volume().

QIODevice *QAudioSink::start()

Gibt einen Zeiger auf das interne QIODevice zurück, das verwendet wird, um Daten an den Audioausgang des Systems zu übertragen. Das Gerät ist bereits geöffnet und write() kann Daten direkt dorthin schreiben.

Wenn QAudioSink auf das Audiogerät des Systems zugreifen kann, gibt state() QtAudio::IdleState zurück, error() gibt QtAudio::NoError zurück und das Signal stateChanged() wird ausgegeben.

Tritt während dieses Vorgangs ein Problem auf, gibt error() QtAudio::OpenError zurück, state() gibt QtAudio::StoppedState zurück und das Signal stateChanged() wird ausgegeben.

Siehe auch QIODevice und QIODevice interface.

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

Startet die QAudioSink mit einer Callback-Funktion, die in einem Soft-Realtime-Audio-Thread aufgerufen wird. Der Callback ist eine Callable, die ein QSpan<SampleType> als Argument erhält, wobei SampleType mit dem QAudioFormat::SampleFormat des Formats von QAudioSink übereinstimmen muss. Der Bereich muss mit verschachtelten Audiodaten gefüllt werden.

Wenn der QAudioSink erfolgreich gestartet werden kann, gibt error() QtAudio::NoError zurück.

Tritt während dieses Vorgangs ein Problem auf, gibt error() QtAudio::OpenError zurück, state() gibt QtAudio::StoppedState zurück und das Signal stateChanged() wird ausgegeben.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch Callback interface.

void QAudioSink::start(QIODevice *device)

Startet die Übertragung von Audiodaten von device an den Audioausgang des Systems. device muss in den Modi ReadOnly oder ReadWrite geöffnet worden sein.

Wenn die QAudioSink erfolgreich Audiodaten ausgeben kann, gibt state() QtAudio::ActiveState zurück, error() gibt QtAudio::NoError zurück und das Signal stateChanged() wird ausgegeben.

Tritt während dieses Vorgangs ein Problem auf, gibt error() QtAudio::OpenError zurück, state() gibt QtAudio::StoppedState zurück und das Signal stateChanged() wird ausgegeben.

Siehe auch QIODevice und QIODevice interface.

QtAudio::State QAudioSink::state() const

Gibt den Status der Audioverarbeitung zurück.

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

Dieses Signal wird ausgesendet, wenn sich das Gerät state geändert hat. Dies ist der aktuelle Zustand des Audioausgangs.

void QAudioSink::stop()

Stoppt die Audioausgabe und trennt sich von der Systemressource.

Setzt error() auf QtAudio::NoError, state() auf QtAudio::StoppedState und gibt das Signal stateChanged() aus.

Siehe auch reset().

void QAudioSink::suspend()

Beendet die Verarbeitung von Audiodaten und bewahrt gepufferte Audiodaten.

Setzt state() auf QtAudio::SuspendedState und gibt das Signal stateChanged() aus.

qreal QAudioSink::volume() const

Liefert die Lautstärke zwischen 0,0 und 1,0 einschließlich.

Siehe auch setVolume().