AudioData

Limited availability

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

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

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 Schreibgeschützt

Gibt das Abtastungsformat des Audios zurück.

AudioData.sampleRate Schreibgeschützt

Gibt die Abtastrate des Audios in Hz zurück.

AudioData.numberOfFrames Schreibgeschützt

Gibt die Anzahl der Frames zurück.

AudioData.numberOfChannels Schreibgeschützt

Gibt die Anzahl der Audiokanäle zurück.

AudioData.duration Schreibgeschützt

Gibt die Dauer des Audios in Mikrosekunden zurück.

AudioData.timestamp Schreibgeschützt

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