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