QAudioSource Class

QFile destinationFile; // Klassenmitglied
QAudioSource* audio;   // Klassenmitglied
{
    destinationFile.setFileName("/tmp/test.raw");
    destinationFile.open( QIODevice::WriteOnly | QIODevice::Truncate );

    QAudioFormat format;
    // Das gewünschte Format festlegen, zum Beispiel:
    format.setSampleRate(44100);
    format.setChannelCount(1);
    format.setSampleFormat(QAudioFormat::Int16);

    QAudioDevice info = 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);
    // Nimmt Audio für 3000 ms auf
}

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

QAudioSource* audio;          // Klassenmitglied.
std::atomic<float> peakLevel; // Klassenmitglied.
{
    QAudioFormat format;
    // Format einrichten, 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 capture audio.";
       return;
    }

    audio = new QAudioSource(format, this);
    audio->start([&peakLevel] (QSpan<float> interleavedAudioBuffer) {
        float level = peakLevel.load();

        for (float sample : interleavedAudioBuffer) {
            // Berechne den Spitzenpegel aus den Audio-Samples
            level = std::max(level, std::abs(sample));
        }

        peakLevel.store(level);
        // Hinweis: Es ist Vorsicht geboten, wenn der Anwendungsthread benachrichtigt werden muss, da der
        // Audio-Callback keine potenziell blockierenden Systemaufrufe verwenden sollte.
       // Gute Optionen sind Autoreset-Ereignisse (Windows), eventfd (Linux) oder kqueue/EVFILT_USER unter macOS.
    });

    if (!audio->error()== QtAudio::Error::NoError) {
       // Zusätzlich zu den anderen `start()`-Signaturen schlägt der Start des Audio-Callbacks fehl, wenn
        // * das Backend keine callback-basierte E/A 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 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;
    }
}

Dokumentation zu Member-Funktionen

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

Erstellen Sie einen neuen Audioeingang und ordnen Sie ihn „ parent “ zu. Das Standard-Audioeingabegerät wird mit den Ausgabeparametern „ format “ verwendet. Wenn „ format “ standardmäßig initialisiert ist, wird das Format auf das bevorzugte Format des Audiogeräts gesetzt.

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

Erstellen Sie einen neuen Audioeingang und ordnen Sie ihn „ parent “ zu. Das Gerät, auf das „ audioDevice “ verweist, wird mit den Eingangsparametern „ format “ verwendet. Wenn „ format “ standardmäßig initialisiert wird, wird das Format auf das bevorzugte Format von „ audioDevice “ gesetzt.

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

Lösche diesen Audioeingang.

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

Gibt die Größe des Audio-Puffers in Frames zurück.

Wird vor dem Aufruf von ` start()` aufgerufen, wird der Plattform-Standardwert zurückgegeben. Wird vor dem Aufruf von ` start() ` aufgerufen, aber zuvor wurden bereits ` setBufferSize()` oder ` setBufferFrameCount()` aufgerufen, wird der durch ` setBufferSize() ` oder ` setBufferFrameCount()` festgelegte Wert zurückgegeben. Wird nach dem Aufruf von ` start()` aufgerufen, wird die tatsächlich verwendete Puffergröße zurückgegeben. Diese entspricht möglicherweise nicht dem Wert, der zuvor durch ` setBufferSize() ` oder ` setBufferFrameCount()` festgelegt wurde.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch setBufferFrameCount() und bufferSize.

qsizetype QAudioSource::bufferSize() const

Gibt die Größe des Audio-Puffers in Byte zurück.

Wird vor dem Aufruf von ` start()` aufgerufen, wird der Standardwert der Plattform zurückgegeben. Wird vor dem Aufruf von ` start() ` aufgerufen, aber zuvor wurden bereits ` setBufferSize()` oder ` setBufferFrameCount()` aufgerufen, wird der durch ` setBufferSize() ` oder ` setBufferFrameCount()` festgelegte Wert zurückgegeben. Wird nach dem Aufruf von ` start()` aufgerufen, wird die tatsächlich verwendete Puffergröße zurückgegeben. Diese entspricht möglicherweise nicht dem Wert, der zuvor durch ` setBufferSize() ` oder ` setBufferFrameCount()` festgelegt wurde.

Siehe auch setBufferSize() und bufferFrameCount.

qsizetype QAudioSource::bytesAvailable() const

Gibt die Menge der zum Lesen verfügbaren Audiodaten in Byte zurück.

Siehe auch „ framesAvailable “.

qint64 QAudioSource::elapsedUSecs() const

Gibt die Zeit in Mikrosekunden seit dem Aufruf von ` start()` zurück, einschließlich der Zeit in den Zuständen „Idle“ und „Suspend“.

QtAudio::Error QAudioSource::error() const

Gibt den Fehlerstatus zurück.

QAudioFormat QAudioSource::format() const

Gibt den derzeit verwendeten „ QAudioFormat “ zurück.

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

Gibt die Menge der zum Auslesen verfügbaren Audiodaten in Frames zurück.

Hinweis: Der Rückgabewert ist nur gültig, solange sich die Funktion im Status „ QtAudio::ActiveState “ oder „ QtAudio::IdleState “ befindet; andernfalls wird Null zurückgegeben.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch „ bytesAvailable “.

bool QAudioSource::isNull() const

Gibt „ true “ zurück, wenn die Audioquelle „ null “ ist; andernfalls wird „ false “ zurückgegeben.

[since 6.12] qsizetype QAudioSource::nativePeriodFrameCount() const

Gibt die native Anzahl der Perioden zurück.

Gibt -1 zurück, wenn nicht festgelegt; andernfalls wird der zuvor mit ` setNativePeriodFrameCount()` festgelegte Wert zurückgegeben.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch „ setNativePeriodFrameCount “.

qint64 QAudioSource::processedUSecs() const

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

void QAudioSource::reset()

Löscht alle Audiodaten in den Puffern und setzt die Puffer auf Null zurück.

void QAudioSource::resume()

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

Setzt „ state()“ auf den Zustand, den der Audio-Sink zum Zeitpunkt des Aufrufs von „ suspend()“ hatte. Diese Funktion führt keine Aktion aus, wenn der Zustand des Audio-Sinks nicht „ QtAudio::SuspendedState “ ist.

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

Stellt die Größe des Audiopuffers auf „ value “ in Frame-Zählung ein.

Die Eigenschaften „ bufferFrameCount “ () und „ bufferSize “ () geben die Größe des Ringpuffers bei Verwendung der „ QIODevice “-APIs an. Die native Periodengröße wird über „ setNativePeriodFrameCount “ () gesteuert.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch bufferFrameCount() und setBufferSize.

void QAudioSource::setBufferSize(qsizetype value)

Stellt die Größe des Audiopuffers auf value Bytes ein.

Die Eigenschaften „ bufferFrameCount()“ und „ bufferSize()“ geben die Ringpuffergröße bei Verwendung der „ QIODevice “-APIs an. Die native Periodengröße wird über „ setNativePeriodFrameCount()“ gesteuert.

Siehe auch bufferSize() und setBufferFrameCount.

[since 6.12] void QAudioSource::setNativePeriodFrameCount(qsizetype frameCount)

Legt die native Perioden-Frame-Anzahl auf „ frameCount “ fest.

Passen Sie die vom Betriebssystem und der Hardware verwendete Audio-Puffergröße an. Standardmäßig (wenn nicht festgelegt) verwendet das System einen plattformabhängigen Wert, typischerweise 1024 Frames (~23 ms bei 44100 Hz).

Verwenden Sie kleinere Werte (64–256), um die Latenz zu verringern, oder größere Werte (2048–4096), um das Risiko von Pufferüberläufen (Dropouts) zu verringern.

Gültige Werte sind 2-Potenzen zwischen 32 und 4096 (einschließlich) oder -1, um die Einstellung aufzuheben. Kann nur aufgerufen werden, wenn die Audioquelle angehalten ist.

Entspricht den plattformspezifischen Einstellungen: kAudioDevicePropertyBufferFrameSize (macOS), IAudioClient::bufferDuration (Windows), PW_KEY_NODE_FORCE_QUANTUM (PipeWire/Linux) und AAudioStreamBuilder_setBufferCapacityInFrames (Android).

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch nativePeriodFrameCount.

void QAudioSource::setVolume(qreal volume)

Stellt die Eingangslautstärke auf „ volume “ ein.

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

Wenn das Gerät die Anpassung der Eingangslautstärke nicht unterstützt, wird „ volume “ ignoriert und die Eingangslautstärke bleibt bei 1,0.

Die Standardlautstärke beträgt 1.0.

Siehe auch ` volume()`.

QIODevice *QAudioSource::start()

Gibt einen Zeiger auf den internen „ QIODevice “ zurück, der zur Übertragung von Daten aus dem Audioeingang des Systems verwendet wird. Das Gerät ist bereits geöffnet, und mit „ read()“ können Daten direkt daraus gelesen werden.

Wenn der „ QAudioSource “ auf das Audio-Gerät des Systems zugreifen kann, gibt ` state()` ` QtAudio::IdleState` zurück, ` error()` gibt ` QtAudio::NoError ` zurück und das Signal ` stateChanged()` wird ausgelöst.

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 ausgelöst.

Siehe auch QIODevice und QIODevice interface.

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

Startet den „ QAudioSource “ mit einer Callback-Funktion, die in einem Soft-Realtime-Audio-Thread aufgerufen wird. Der Callback ist ein Callable, das ein „ QSpan<const SampleType>“ als Argument entgegennimmt. „SampleType“ muss mit dem „ QAudioFormat::SampleFormat “ des Formats des „ QAudioSource “ übereinstimmen. Der Bereich enthält die verschachtelten Audiodaten.

Wenn der „ QAudioSource “ 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 ausgelöst.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch „ Callback interface “.

void QAudioSource::start(QIODevice *device)

Beginnt mit der Übertragung von Audiodaten vom Audioeingang des Systems an den „ device “. Der „ device “ muss zuvor in den Modi „ WriteOnly “, „ Append “ oder „ ReadWrite “ geöffnet worden sein.

Wenn der ` QAudioSource ` erfolgreich Audiodaten empfangen kann, gibt ` state()` entweder ` QtAudio::ActiveState ` oder ` 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 ausgelöst.

Siehe auch QIODevice und QIODevice interface.

QtAudio::State QAudioSource::state() const

Gibt den Status der Audioverarbeitung zurück.

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

Dieses Signal wird ausgelöst, wenn sich die Eigenschaft „ state “ des Geräts geändert hat.

void QAudioSource::stop()

Beendet die Audioeingabe und trennt die Verbindung zur Systemressource.

Setzt „ error “ () auf „ QtAudio::NoError “, „ state “ () auf „ QtAudio::StoppedState “ und löst das Signal „ stateChanged “ () aus.

void QAudioSource::suspend()

Beendet die Verarbeitung von Audiodaten, wobei die gepufferten Audiodaten erhalten bleiben.

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

qreal QAudioSource::volume() const

Gibt die Eingangslautstärke zurück.

Wenn das Gerät die Anpassung der Eingangslautstärke nicht unterstützt, beträgt der Rückgabewert 1,0.

Siehe auch setVolume().