QAudioSink Class

QFile sourceFile; // class member.QAudioSink* audio; // class member.{ sourceFile.setFileName("/tmp/test.raw"); sourceFile.open(QIODevice::ReadOnly);    QAudioFormat format; // Einrichten des Formats, z.B.format.setSampleRate(8000); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::UInt8);    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;
}

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;
    }
}

Dokumentation der Mitgliederfunktionen

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

Erstellen Sie einen neuen Audioausgang und verbinden Sie ihn mit parent. Das Standard-Audioausgabegerät wird mit den Parametern für die Ausgabe format verwendet.

[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.

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

Zerstört diesen Audioausgang.

Dadurch werden alle verwendeten Systemressourcen und Puffer freigegeben.

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 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 QAudioSink::bytesFree() const

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

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.

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, und setzt error() auf QAudioError::NoError. Diese Funktion bewirkt nichts, wenn der Zustand der Audiosenke nicht QtAudio::SuspendedState ist.

void QAudioSink::setBufferSize(qsizetype value)

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

Siehe auch bufferSize().

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.

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.

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 error() auf QtAudio::NoError, 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().