AudioData

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Hinweis: Dieses Feature ist verfügbar in Dedicated Web Workers.

Die AudioData-Schnittstelle der WebCodecs API repräsentiert eine Audio-Abtastung.

AudioData ist ein übertragbares Objekt.

Beschreibung

Eine Audiospur besteht aus einem Strom von Audio-Abtastungen, wobei jede Abtastung einen erfassten Moment eines Tons darstellt. Ein AudioData-Objekt ist eine Darstellung einer solchen Abtastung. In Verbindung mit den Schnittstellen der Insertable Streams API können Sie einen Strom in einzelne AudioData-Objekte mit MediaStreamTrackProcessor aufteilen oder eine Audiospur aus einem Strom von Frames mit MediaStreamTrackGenerator konstruieren.

Hinweis: Erfahren Sie mehr über Audio im Web in Digitale Audiokonzepten.

Die Medienressource

Ein AudioData-Objekt enthält einen Verweis auf eine angehängte Medienressource. Diese Medienressource enthält die tatsächlichen Audio-Abtastungsdaten, die durch das Objekt beschrieben werden. Eine Medienressource wird vom Benutzeragenten verwaltet, bis sie nicht mehr von einem AudioData-Objekt referenziert wird, zum Beispiel, wenn AudioData.close() aufgerufen wird.

Planes und Audioformat

Um das Abtastungsformat eines AudioData zurückzugeben, verwenden Sie die Eigenschaft AudioData.format. Das Format kann als interleaved oder planar beschrieben werden. In interleaved Formaten werden die Audio-Abtastungen der verschiedenen Kanäle in einem einzigen Puffer angeordnet, der als plane beschrieben wird. Diese plane enthält eine Anzahl von Elementen, die gleich AudioData.numberOfFrames * AudioData.numberOfChannels ist.

Im planen Format ist die Anzahl der Planes gleich AudioData.numberOfChannels, und jede Plane ist ein Puffer mit einer Anzahl von Elementen, die gleich AudioData.numberOfFrames ist.

Konstruktor

AudioData()

Erstellt ein neues AudioData-Objekt.

Instanz-Eigenschaften

AudioData.format Nur lesbar

Gibt das Abtastungsformat des Audios zurück.

AudioData.sampleRate Nur lesbar

Gibt die Abtastrate des Audios in Hz zurück.

AudioData.numberOfFrames Nur lesbar

Gibt die Anzahl der Frames zurück.

AudioData.numberOfChannels Nur lesbar

Gibt die Anzahl der Audiokanäle zurück.

AudioData.duration Nur lesbar

Gibt die Dauer des Audios in Mikrosekunden zurück.

AudioData.timestamp Nur lesbar

Gibt den Zeitstempel des Audios in Mikrosekunden zurück.

Instanz-Methoden

AudioData.allocationSize()

Gibt die Anzahl von Bytes zurück, die zur Aufnahme der Abtastung benötigt werden, gefiltert durch die in die Methode übergebenen Optionen.

AudioData.copyTo()

Kopiert die Abtastungen aus der angegebenen Plane des AudioData-Objekts zum Ziel.

AudioData.clone()

Erstellt ein neues AudioData-Objekt mit Verweis auf dieselbe Medienressource wie das Original.

AudioData.close()

Löscht alle Zustände und gibt den Verweis auf die Medienressource frei.

Spezifikationen

Specification
WebCodecs
# audiodata-interface

Browser-Kompatibilität

BCD tables only load in the browser