QAudioSource Class

QFile destinationFile; // KlassenmitgliedQAudioSource* audio; // Klassenmitglied{ destinationFile.setFileName("/tmp/test.raw"); destinationFile.open( QIODevice::WriteOnly | QIODevice::Truncate );  QAudioFormat format; // Einstellen des gewünschten Formats, 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 3000ms auf}

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

QAudioSource* audio; // Klassenmitglied.std::atomic<float> peakLevel; // 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 capture audio.";
       return; } audio = new QAudioSource(format, this);  audio->start([&peakLevel] (QSpan<float> interleavedAudioBuffer) { float level = peakLevel.load(); for(float sample : interleavedAudioBuffer) { // Berechnung des Spitzenpegels aus den Audio-Sampleslevel = std::max(level, std::abs(sample)); } peakLevel.store(level); // Hinweis: Wenn der Anwendungsthread benachrichtigt werden muss, ist Vorsicht geboten, da der // Audio-Callback keine potenziell blockierenden Systemaufrufe verwenden sollte.
       // Gute Optionen sind autoreset events (windows), eventfd (linux) oder kqueue/EVFILT_USER auf 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 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 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 der Mitgliederfunktionen

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

Konstruieren Sie einen neuen Audioeingang und schließen Sie ihn an parent an. Das Standard-Audioeingabegerä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] QAudioSource::QAudioSource(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

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

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

Zerstören Sie diesen Audioeingang.

qsizetype QAudioSource::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.

Siehe auch setBufferFrameCount() und bufferSize.

[since 6.10] qsizetype QAudioSource::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.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch setBufferSize() und bufferFrameCount.

qsizetype QAudioSource::bytesAvailable() const

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

Siehe auch framesAvailable.

qint64 QAudioSource::elapsedUSecs() const

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

QtAudio::Error QAudioSource::error() const

Gibt den Fehlerstatus zurück.

QAudioFormat QAudioSource::format() const

Gibt die QAudioFormat zurück, die verwendet wird.

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

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

Hinweis: Der zurückgegebene Wert ist nur im Zustand QtAudio::ActiveState oder QtAudio::IdleState gültig, ansonsten 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.

qint64 QAudioSource::processedUSecs() const

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

void QAudioSource::reset()

Verwirft alle Audiodaten in den Puffern, setzt die Puffer auf Null zurück.

void QAudioSource::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.

void QAudioSource::setBufferFrameCount(qsizetype value)

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

Siehe auch bufferFrameCount() und setBufferSize.

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

Setzt die Größe des Audiopuffers auf value bytes.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch bufferSize() und setBufferFrameCount.

void QAudioSource::setVolume(qreal volume)

Setzt die Eingangslautstä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.

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

Die Standardlautstärke ist 1.0.

Siehe auch volume().

QIODevice *QAudioSource::start()

Gibt einen Zeiger auf das interne QIODevice zurück, das zur Übertragung von Daten vom Audioeingang des Systems verwendet wird. Das Gerät ist bereits geöffnet und read() kann Daten direkt von ihm lesen.

Wenn QAudioSource 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_source_callback<Callback> = true> void QAudioSource::start(Callback &&cb)

Startet die QAudioSource mit einer Callback-Funktion, die in einem Soft-Realtime-Audio-Thread aufgerufen wird. Der Callback ist eine Callable, die ein QSpan<const SampleType> als Argument erhält, wobei SampleType mit dem QAudioFormat::SampleFormat des Formats von QAudioSource übereinstimmen muss. Der Span 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 ausgegeben.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch Callback interface.

void QAudioSource::start(QIODevice *device)

Startet die Übertragung von Audiodaten vom Audioeingang des Systems an device. device muss in den Modi WriteOnly, Append oder ReadWrite geöffnet worden sein.

Wenn QAudioSource erfolgreich Audiodaten abrufen 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 ausgegeben.

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 ausgegeben, wenn sich das Gerät state geändert hat.

void QAudioSource::stop()

Stoppt den Audioeingang und trennt sich von der Systemressource.

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

void QAudioSource::suspend()

Beendet die Verarbeitung von Audiodaten und bewahrt gepufferte Audiodaten.

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 Einstellung der Eingangslautstärke nicht unterstützt, ist der zurückgegebene Wert 1.0.

Siehe auch setVolume().