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(8000); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::UInt8);    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;
}

void AudioInputExample::handleStateChanged(QAudio::State newState)
{
    switch (newState) {
        case QAudio::StoppedState:
            if (audio->error() != QAudio::NoError) {
                // Error handling
            } else {
                // Finished recording
            }
            break;

        case QAudio::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 verbinden Sie ihn mit parent. Das Standard-Audioeingangsgerät wird mit den Parametern des Ausgangs format verwendet.

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

Konstruieren Sie einen neuen Audioeingang und schließen Sie ihn an parent an. Das Gerät, auf das audioDevice verweist, wird mit den Parametern des Eingangs format verwendet.

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

Zerstören Sie diesen Audioeingang.

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 zuvor setBufferSize() aufgerufen wurde, wird der durch setBufferSize() festgelegte Wert zurückgegeben. Wenn nach start() aufgerufen, wird die tatsächlich verwendete Puffergröße zurückgegeben. Dies ist möglicherweise nicht der Wert, der zuvor durch setBufferSize() gesetzt wurde.

Siehe auch setBufferSize().

qsizetype QAudioSource::bytesAvailable() const

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

Hinweis: Der zurückgegebene Wert ist nur im Zustand QtAudio::ActiveState oder QtAudio::IdleState gültig, ansonsten wird Null zurückgegeben.

qint64 QAudioSource::elapsedUSecs() const

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

QtAudio::Error QAudioSource::error() const

Gibt den Fehlerstatus zurück.

QAudioFormat QAudioSource::format() const

Gibt die QAudioFormat zurück, die verwendet wird.

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 error() auf QtAudio::NoError. Setzt state() auf QtAudio::ActiveState, wenn Sie zuvor start(QIODevice*) aufgerufen haben. Setzt state() auf QtAudio::IdleState, wenn Sie zuvor start() aufgerufen haben. gibt das Signal stateChanged() aus.

void QAudioSource::setBufferSize(qsizetype value)

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

Hinweis: Diese Funktion kann jederzeit vor start() aufgerufen werden, Aufrufe nach start() werden ignoriert. Es sollte nicht davon ausgegangen werden, dass die eingestellte Puffergröße die tatsächlich verwendete Puffergröße ist. Der Aufruf von bufferSize() zu einem beliebigen Zeitpunkt nach start() gibt die tatsächlich verwendete Puffergröße zurück.

Siehe auch bufferSize().

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.

Hinweis: Anpassungen der Lautstärke ändern die Lautstärke dieses Audiostroms, nicht die globale Lautstärke.

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.

void QAudioSource::start(QIODevice *device)

Beginnt mit der Übertragung von Audiodaten vom Audioeingang des Systems zum device. Der 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.

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