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 GitHubLegend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support