[go: up one dir, main page]

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

PeriodicWave: PeriodicWave() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨April 2021⁩.

Der PeriodicWave() Konstruktor der Web Audio API erstellt eine neue PeriodicWave-Objektinstanz.

Syntax

js
new PeriodicWave(context)
new PeriodicWave(context, options)

Parameter

context

Ein BaseAudioContext, das den Audiokontext darstellt, mit dem der Knoten verknüpft werden soll.

options Optional

Ein PeriodicWaveOptions Dictionary-Objekt, das die Eigenschaften definiert, die Sie der PeriodicWave zuweisen möchten (Es erbt auch die Optionen, die im PeriodicWaveConstraints Dictionary definiert sind.):

real

Ein Float32Array, das die Cosinus-Terme enthält, die Sie zur Bildung der Welle verwenden möchten (entspricht dem real Parameter von BaseAudioContext.createPeriodicWave).

imag

Ein Float32Array, das die Sinus-Terme enthält, die Sie zur Bildung der Welle verwenden möchten (entspricht dem imag-Parameter von BaseAudioContext.createPeriodicWave).

channelCount

Stellt eine ganze Zahl dar, die verwendet wird, um zu bestimmen, wie viele Kanäle beim Up-Mixing und Down-Mixing von Verbindungen zu allen Eingängen des Knotens verwendet werden. (Siehe AudioNode.channelCount für weitere Informationen.) Seine Verwendung und genaue Definition hängen vom Wert von channelCountMode ab.

channelCountMode

Stellt einen enumerierten Wert dar, der beschreibt, wie Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich Standardwerten.)

channelInterpretation

Stellt einen enumerierten Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation wird definieren, wie Audio Up-Mixing und Down-Mixing durchgeführt wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich Standardwerte.)

Rückgabewert

Eine neue PeriodicWave-Objektinstanz.

Beispiele

js
const real = new Float32Array(2);
const imag = new Float32Array(2);
const ac = new AudioContext();

real[0] = 0;
imag[0] = 0;
real[1] = 1;
imag[1] = 0;

const wave = new PeriodicWave(ac, {
  real,
  imag,
  disableNormalization: false,
});

Spezifikationen

Specification
Web Audio API
# dom-periodicwave-periodicwave

Browser-Kompatibilität