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-Probe.

AudioData ist ein übertragbares Objekt.

Beschreibung

Eine Audiospur besteht aus einem Strom von Audio-Proben, wobei jede Probe einen aufgenommenen Moment des Tons darstellt. Ein AudioData-Objekt ist eine Darstellung einer solchen Probe. In Verbindung mit den Schnittstellen der Insertable Streams API können Sie einen Strom in einzelne AudioData-Objekte zerlegen, z. B. mit dem MediaStreamTrackProcessor, oder eine Audiospur aus einem Strom von Frames mit dem MediaStreamTrackGenerator erstellen.

Hinweis: Erfahren Sie mehr über Audio im Web in Digital Audio Concepts.

Die Medienressource

Ein AudioData-Objekt enthält eine Referenz zu einer angehängten Medienressource. Diese Medienressource enthält die tatsächlich von dem Objekt beschriebenen Audiodaten. Eine Medienressource wird vom Benutzeragenten verwaltet, bis sie nicht mehr von einem AudioData-Objekt referenziert wird, zum Beispiel, wenn AudioData.close() aufgerufen wird.

Ebenen und Audioformat

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

Im planaren Format ist die Anzahl der Ebenen gleich der Anzahl von AudioData.numberOfChannels, und jede Ebene ist ein Puffer, der eine Anzahl von Elementen enthält, die gleich der Anzahl von AudioData.numberOfFrames ist.

Konstruktor

AudioData()

Erstellt ein neues AudioData-Objekt.

Instanz-Eigenschaften

AudioData.format Schreibgeschützt

Gibt das Format der Audio-Probe zurück.

AudioData.sampleRate Schreibgeschützt

Gibt die Samplerate 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 der Bytes zurück, die benötigt werden, um die Probe entsprechend den in die Methode übergebenen Optionen zu halten.

AudioData.copyTo()

Kopiert die Samples von der angegebenen Ebene 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 die Referenz zur Medienressource frei.

Spezifikationen

Specification
WebCodecs
# audiodata-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
AudioData
AudioData() constructor
allocationSize
clone
close
copyTo
duration
format
numberOfChannels
numberOfFrames
sampleRate
timestamp

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support