QAudioDecoder Class

Dokumentation der Mitgliedsfunktionen

[explicit] QAudioDecoder::QAudioDecoder(QObject *parent = nullptr)

Erstellen Sie eine QAudioDecoder-Instanz mit ` parent`.

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

Löscht das Audio-Decoder-Objekt.

QAudioFormat QAudioDecoder::audioFormat() const

Gibt das Audioformat zurück, auf das der Decoder eingestellt ist.

Siehe auch setAudioFormat() und formatChanged().

bool QAudioDecoder::bufferAvailable() const

Gibt „true“ zurück, wenn ein Puffer zum Lesen verfügbar ist, andernfalls „false“. Ist kein Puffer verfügbar, gibt der Aufruf der Funktion „ read()“ einen ungültigen Puffer zurück.

[signal] void QAudioDecoder::bufferAvailableChanged(bool available)

Zeigt an, ob (sofern „ available “ wahr ist) ein neuer Puffer verfügbar ist.

Ist „ available “ falsch, sind keine Puffer verfügbar.

Siehe auch „ bufferAvailable()“ und „ bufferReady()“.

[signal] void QAudioDecoder::bufferReady()

Zeigt an, dass ein neuer dekodierter Audio-Puffer zum Auslesen bereitsteht.

Siehe auch „ read()“ und „ bufferAvailable()“.

qint64 QAudioDecoder::duration() const

Gibt die Gesamtdauer (in Millisekunden) des Audiostreams zurück oder -1, falls diese nicht verfügbar ist.

[signal] void QAudioDecoder::durationChanged(qint64 duration)

Zeigt an, dass sich die geschätzte duration der decodierten Daten geändert hat.

Siehe auch „ positionChanged()“.

QAudioDecoder::Error QAudioDecoder::error() const

Gibt den aktuellen Fehlerstatus des „ QAudioDecoder “ zurück.

[signal] void QAudioDecoder::error(QAudioDecoder::Error error)

Zeigt an, dass ein „ error “-Zustand aufgetreten ist.

// Connect using qOverload:
connect(audioDecoder, qOverload(&QAudioDecoder::error),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(audioDecoder, qOverload(&QAudioDecoder::error),
        this, [](QAudioDecoder::Error error) { /* handle error */ });

Siehe auch ` errorString()`.

[signal] void QAudioDecoder::finished()

Zeigt an, dass die Dekodierung erfolgreich abgeschlossen wurde. Wenn die Dekodierung fehlschlägt, wird stattdessen ein Fehlersignal ausgegeben.

Siehe auch start(), stop() und error().

[signal] void QAudioDecoder::formatChanged(const QAudioFormat &format)

Zeigt an, dass sich das aktuelle Audioformat des Decoders zu „ format “ geändert hat.

Siehe auch „ audioFormat()“ und „ setAudioFormat()“.

bool QAudioDecoder::isSupported() const

Gibt „true“ zurück, wenn die Audio-Decodierung auf dieser Plattform unterstützt wird.

qint64 QAudioDecoder::position() const

Gibt die Position (in Millisekunden) des zuletzt vom Decoder gelesenen Puffers zurück oder -1, wenn noch keine Puffer gelesen wurden.

[signal] void QAudioDecoder::positionChanged(qint64 position)

Zeigt an, dass sich die aktuelle position des Decoders geändert hat.

Siehe auch „ durationChanged()“.

QAudioBuffer QAudioDecoder::read() const

Liest einen Puffer aus dem Decoder, sofern einer verfügbar ist. Gibt einen ungültigen Puffer zurück, wenn derzeit keine decodierten Puffer verfügbar sind oder wenn ein Fehler auftritt. In beiden Fällen blockiert diese Funktion nicht.

Sie sollten entweder auf das Signal „ bufferReady()“ reagieren oder die Funktion „ bufferAvailable()“ überprüfen, bevor Sie „read()“ aufrufen, um sicherzustellen, dass Sie brauchbare Daten erhalten.

void QAudioDecoder::setAudioFormat(const QAudioFormat &format)

Legen Sie das gewünschte Audioformat für decodierte Samples auf „ format “ fest.

Diese Eigenschaft kann nur festgelegt werden, wenn der Decoder angehalten ist. Wird diese Eigenschaft zu einem anderen Zeitpunkt festgelegt, wird sie ignoriert.

Wenn der Decoder dieses Format nicht unterstützt, wird „ error()“ auf „ FormatError “ gesetzt.

Wenn Sie kein Format angeben, wird das Format des decodierten Audios selbst verwendet. Andernfalls wird eine Formatkonvertierung durchgeführt.

Wenn Sie das decodierte Format auf das der ursprünglichen Audiodatei zurücksetzen möchten, können Sie einen ungültigen Wert für ` format` angeben.

Siehe auch ` audioFormat()`.

void QAudioDecoder::setSource(const QUrl &fileName)

Setzt den Namen der aktuellen Audiodatei auf „ fileName “.

Wenn diese Eigenschaft gesetzt wird, wird die aktuelle Dekodierung angehalten und alle Audiopuffer werden verworfen.

Sie können entweder einen Quelldateinamen oder eine Quell- QIODevice angeben. Wird eine der beiden Optionen festgelegt, wird die andere zurückgesetzt.

Siehe auch ` source()`.

void QAudioDecoder::setSourceDevice(QIODevice *device)

Setzt die aktuelle Audio- QIODevice e auf „ device “.

Wenn diese Eigenschaft festgelegt wird, wird die aktuelle Dekodierung angehalten und alle Audiopuffer werden verworfen.

Sie können entweder einen Quelldateinamen oder eine Quell QIODevice angeben. Wird eine der beiden Optionen festgelegt, wird die andere zurückgesetzt.

Siehe auch ` sourceDevice()`.

QUrl QAudioDecoder::source() const

Gibt den Namen der aktuell zu dekodierenden Datei zurück. Wenn „ setSourceDevice “ aufgerufen wurde, ist dieser Wert leer.

Siehe auch „ setSource()“.

[signal] void QAudioDecoder::sourceChanged()

Zeigt an, dass sich die Stromquelle des Decoders geändert hat.

Siehe auch source() und sourceDevice().

QIODevice *QAudioDecoder::sourceDevice() const

Gibt den aktuellen Quell QIODevice zurück, sofern einer festgelegt wurde. Wurde setSource() aufgerufen, ist dies ein nullptr.

Siehe auch ` setSourceDevice()`.

[slot] void QAudioDecoder::start()

Beginnt mit der Dekodierung der Audio-Ressource.

Während die Daten dekodiert werden, wird das Signal „ bufferReady()“ ausgegeben, sobald genügend Daten dekodiert wurden. Der Aufruf von „ read()“ gibt dann ohne Blockierung einen Audio-Puffer zurück.

Wenn Sie ` read()` aufrufen, bevor ein Puffer bereit ist, wird ein ungültiger Puffer zurückgegeben, ebenfalls ohne Blockierung.

Siehe auch read().

[slot] void QAudioDecoder::stop()

Beende die Audiodekodierung. Durch erneuten Aufruf von ` start()` wird die Dekodierung von Anfang an fortgesetzt.