AudioData

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.

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

Browser-Kompatibilität