[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/de/docs/Web/API/BaseAudioContext/createScriptProcessor [Back]  [Original]

BaseAudioContext: createScriptProcessor()-Methode - Web-APIs | MDN

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

View in English Always switch to English

BaseAudioContext: createScriptProcessor()-Methode

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Die createScriptProcessor()-Methode der BaseAudioContext-Schnittstelle erstellt ein ScriptProcessorNode zur direkten Audioverarbeitung.

Hinweis: Diese Funktion wurde durch AudioWorklets und die AudioWorkletNode-Schnittstelle ersetzt.

In diesem Artikel

Syntax

js
createScriptProcessor(bufferSize, numberOfInputChannels, numberOfOutputChannels)

Parameter

bufferSize

Die Puffergre in Einheiten von Abtastrahmen. Wenn angegeben, muss die bufferSize einen der folgenden Werte haben: 256, 512, 1024, 2048, 4096, 8192, 16384. Wenn sie nicht angegeben wird oder der Wert 0 ist, whlt die Implementierung die beste Puffergre fr die gegebene Umgebung, die whrend der gesamten Lebensdauer des Knotens eine konstante Potenz von 2 sein wird.

Dieser Wert steuert, wie hufig das audioprocess-Ereignis ausgelst wird und wie viele Abtastrahmen bei jedem Aufruf bearbeitet werden mssen. Niedrigere Werte fr bufferSize fhren zu einer geringeren (besseren) Latenz. Hhere Werte sind notwendig, um Audioausflle und Strungen zu vermeiden. Es wird empfohlen, diese Puffergre nicht anzugeben und die Implementierung eine gute Puffergre auswhlen zu lassen, um ein Gleichgewicht zwischen Latenz und Audioqualitt zu erreichen.

numberOfInputChannels

Ganzzahl, die die Anzahl der Kanle fr den Eingang dieses Knotens angibt, standardmig 2. Werte bis zu 32 werden untersttzt.

numberOfOutputChannels

Ganzzahl, die die Anzahl der Kanle fr den Ausgang dieses Knotens angibt, standardmig 2. Werte bis zu 32 werden untersttzt.

Warnung: WebKit erfordert derzeit (Version 31), dass eine gltige bufferSize bergeben wird, wenn diese Methode aufgerufen wird.

Hinweis: Es ist ungltig, wenn sowohl numberOfInputChannels als auch numberOfOutputChannels null sind.

Rckgabewert

Ein ScriptProcessorNode.

Beispiele

Hinzufgen von weiem Rauschen mit einem Script-Prozessor

Das folgende Beispiel zeigt, wie ein ScriptProcessorNode verwendet wird, um eine Spur, die ber AudioContext.decodeAudioData() geladen wurde, zu verarbeiten. Dabei wird jedem Audiosample der Eingabespur ein wenig weies Rauschen hinzugefgt und ber den AudioDestinationNode abgespielt.

Fr jeden Kanal und jeden Abtastrahmen verwendet der audioprocess-Ereignishandler des Skriptnodens das zugehrige audioProcessingEvent, um durch jeden Kanal des Eingabebuffers und jedes Sample in jedem Kanal zu schleifen und eine kleine Menge weies Rauschen hinzuzufgen, bevor dieses Ergebnis in jedem Fall als Ausgabesample gesetzt wird.

js
const myScript = document.querySelector("script");
const myPre = document.querySelector("pre");
const playButton = document.querySelector("button");

// Create AudioContext and buffer source
let audioCtx;

async function init() {
  audioCtx = new AudioContext();
  const source = audioCtx.createBufferSource();

  // Create a ScriptProcessorNode with a bufferSize of 4096 and
  // a single input and output channel
  const scriptNode = audioCtx.createScriptProcessor(4096, 1, 1);

  // Load in an audio track using fetch() and decodeAudioData()
  try {
    const response = await fetch("viper.ogg");
    const arrayBuffer = await response.arrayBuffer();
    source.buffer = await audioCtx.decodeAudioData(arrayBuffer);
  } catch (err) {
    console.error(
      `Unable to fetch the audio file: ${name} Error: ${err.message}`,
    );
  }

  // Give the node a function to process audio events
  scriptNode.addEventListener("audioprocess", (audioProcessingEvent) => {
    // The input buffer is the song we loaded earlier
    let inputBuffer = audioProcessingEvent.inputBuffer;

    // The output buffer contains the samples that will be modified and played
    let outputBuffer = audioProcessingEvent.outputBuffer;

    // Loop through the output channels (in this case there is only one)
    for (let channel = 0; channel < outputBuffer.numberOfChannels; channel++) {
      let inputData = inputBuffer.getChannelData(channel);
      let outputData = outputBuffer.getChannelData(channel);

      // Loop through the 4096 samples
      for (let sample = 0; sample < inputBuffer.length; sample++) {
        // make output equal to the same as the input
        outputData[sample] = inputData[sample];

        // add noise to each output sample
        outputData[sample] += (Math.random() * 2 - 1) * 0.1;
      }
    }
  });

  source.connect(scriptNode);
  scriptNode.connect(audioCtx.destination);
  source.start();

  // When the buffer source stops playing, disconnect everything
  source.addEventListener("ended", () => {
    source.disconnect(scriptNode);
    scriptNode.disconnect(audioCtx.destination);
  });
}

// wire up play button
playButton.addEventListener("click", () => {
  if (!audioCtx) {
    init();
  }
});

Spezifikationen

Spezifikation
Web Audio API
# dom-baseaudiocontext-createscriptprocessor

Browser-Kompatibilitt

Siehe auch


Web Proxy Viewer  |  New URL  |  Original Page