QAudioDecoder Class

Member Function Dokumentation

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

Konstruieren Sie eine QAudioDecoder-Instanz mit parent.

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

Zerstört 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. Wenn kein Puffer verfügbar ist, wird beim Aufruf der Funktion read() ein ungültiger Puffer zurückgegeben.

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

Signalisiert die Verfügbarkeit (wenn available wahr ist) eines neuen Puffers.

Wenn available falsch ist, sind keine Puffer verfügbar.

Siehe auch bufferAvailable() und bufferReady().

[signal] void QAudioDecoder::bufferReady()

Signalisiert, dass ein neuer dekodierter Audiopuffer zum Lesen verfügbar ist.

Siehe auch read() und bufferAvailable().

qint64 QAudioDecoder::duration() const

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

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

Signalisiert, dass sich die geschätzte duration der dekodierten Daten geändert hat.

Siehe auch positionChanged().

QAudioDecoder::Error QAudioDecoder::error() const

Gibt den aktuellen Fehlerstatus der QAudioDecoder zurück.

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

Signalisiert, dass eine error Bedingung aufgetreten ist.

Hinweis: Das Signal error ist in dieser Klasse überladen. Um sich mit diesem Signal zu verbinden, indem man die Funktionszeigersyntax verwendet, bietet Qt einen praktischen Helfer, um den Funktionszeiger zu erhalten, wie in diesem Beispiel gezeigt:

connect(audioDecoder, QOverload<QAudioDecoder::Error>::of(&QAudioDecoder::error),
    [=](QAudioDecoder::Error error){ /* ... */ });

Siehe auch errorString().

[signal] void QAudioDecoder::finished()

Signalisiert, 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)

Signalisiert, dass das aktuelle Audioformat des Decoders zu format gewechselt hat.

Siehe auch audioFormat() und setAudioFormat().

bool QAudioDecoder::isSupported() const

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

qint64 QAudioDecoder::position() const

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

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

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

Siehe auch durationChanged().

QAudioBuffer QAudioDecoder::read() const

Liest einen Puffer aus dem Decoder, falls ein solcher vorhanden ist. Gibt einen ungültigen Puffer zurück, wenn derzeit keine dekodierten Puffer verfügbar sind, oder im Fehlerfall. In beiden Fällen wird diese Funktion nicht blockiert.

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

void QAudioDecoder::setAudioFormat(const QAudioFormat &format)

Stellen Sie das gewünschte Audioformat für dekodierte Samples auf format ein.

Diese Eigenschaft kann nur eingestellt werden, wenn der Decoder angehalten ist. Die Einstellung dieser Eigenschaft zu anderen Zeiten wird ignoriert.

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

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

Wenn Sie das dekodierte Format auf das der ursprünglichen Audiodatei zurücksetzen möchten, können Sie ein ungültiges format angeben.

Siehe auch audioFormat().

void QAudioDecoder::setSource(const QUrl &fileName)

Setzt den aktuellen Audiodateinamen auf fileName.

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

Sie können nur entweder einen Quelldateinamen oder eine Quelle QIODevice angeben. Das Setzen der einen Eigenschaft hebt das Setzen der anderen auf.

Siehe auch source().

void QAudioDecoder::setSourceDevice(QIODevice *device)

Setzt das aktuelle Audio QIODevice auf device.

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

Sie können nur entweder einen Quelldateinamen oder eine Quelle QIODevice angeben. Wird eine Eigenschaft gesetzt, wird die andere aufgehoben.

Siehe auch sourceDevice().

QUrl QAudioDecoder::source() const

Gibt den aktuellen zu dekodierenden Dateinamen zurück. Wenn setSourceDevice aufgerufen wurde, ist dieser Wert leer.

Siehe auch setSource().

[signal] void QAudioDecoder::sourceChanged()

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

Siehe auch source() und sourceDevice().

QIODevice *QAudioDecoder::sourceDevice() const

Gibt die aktuelle Quelle QIODevice zurück, falls eine gesetzt wurde. Wenn setSource() aufgerufen wurde, ist dies eine Nullptr.

Siehe auch setSourceDevice().

[slot] void QAudioDecoder::start()

Beginnt mit der Dekodierung der Audioressource.

Während die Daten dekodiert werden, wird das Signal bufferReady() ausgegeben, wenn genügend Daten dekodiert wurden. Der Aufruf von read() gibt dann einen Audiopuffer zurück, ohne zu blockieren.

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

Siehe auch read().

[slot] void QAudioDecoder::stop()

Stoppt die Dekodierung von Audio. Wenn Sie start() erneut aufrufen, wird die Dekodierung von Anfang an fortgesetzt.