AudioData
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.
Die AudioData-Schnittstelle der WebCodecs API repräsentiert ein Audio-Sample.
AudioData ist ein übertragbares Objekt.
Konstruktor
AudioData()-
Erstellt ein neues
AudioData-Objekt.
Instanzeigenschaften
AudioData.formatSchreibgeschützt-
Gibt das Sample-Format der Audiodaten zurück.
AudioData.sampleRateSchreibgeschützt-
Gibt die Abtastrate der Audiodaten in Hz zurück.
AudioData.numberOfFramesSchreibgeschützt-
Gibt die Anzahl der Frames zurück.
AudioData.numberOfChannelsSchreibgeschützt-
Gibt die Anzahl der Audiokanäle zurück.
AudioData.durationSchreibgeschützt-
Gibt die Dauer der Audiodaten in Mikrosekunden zurück.
AudioData.timestampSchreibgeschützt-
Gibt den Zeitstempel der Audiodaten in Mikrosekunden zurück.
Instanzmethoden
AudioData.allocationSize()-
Gibt die Anzahl der Bytes zurück, die zum Speichern des Samples unter Berücksichtigung der an die Methode übergebenen Optionen erforderlich sind.
AudioData.copyTo()-
Kopiert die Samples aus der angegebenen Ebene des
AudioData-Objekts in das Ziel. AudioData.clone()-
Erstellt ein neues
AudioData-Objekt, das auf dieselbe Medienressource wie das Original verweist. AudioData.close()-
Löscht sämtliche Zustände und gibt die Referenz auf die Medienressource frei.
Beschreibung
Eine Audiospur besteht aus einem Strom von Audio-Samples, von denen jedes einen aufgenommenen Moment des Schalls repräsentiert. Ein AudioData-Objekt stellt ein solches Sample dar. In Verbindung mit den Schnittstellen der Insertable Streams API können Sie einen Strom mithilfe von MediaStreamTrackProcessor in einzelne AudioData-Objekte zerlegen oder mithilfe von MediaStreamTrackGenerator aus einem Strom von Frames eine Audiospur erstellen.
Hinweis: Weitere Informationen zu Audio im Web finden Sie unter Grundlagen digitaler Audiodaten.
Die Medienressource
Ein AudioData-Objekt enthält eine Referenz auf eine zugehörige Medienressource. Diese Medienressource enthält die eigentlichen Audio-Sample-Daten, die das Objekt beschreibt. Der User-Agent verwaltet eine Medienressource, solange ein AudioData-Objekt auf sie verweist, beispielsweise bis AudioData.close() aufgerufen wird.
Ebenen und Audioformat
Um das Sample-Format eines AudioData-Objekts abzurufen, verwenden Sie die Eigenschaft AudioData.format. Das Format kann als interleaved (verschachtelt) oder planar (ebenenbasiert) beschrieben werden. Bei interleaved-Formaten liegen die Audio-Samples der verschiedenen Kanäle in einem einzigen Puffer, der als Ebene bezeichnet wird. Diese Ebene enthält eine Anzahl von Elementen, die AudioData.numberOfFrames * AudioData.numberOfChannels entspricht.
Beim planaren Format entspricht die Anzahl der Ebenen AudioData.numberOfChannels. Jede Ebene ist ein Puffer, dessen Elementanzahl AudioData.numberOfFrames entspricht.
Spezifikationen
| Spezifikation |
|---|
| WebCodecs # audiodata-interface |