2023/04/06 時点の英語版に基づき新規翻訳

files/ja/web/api/analysernode/getfloattimedomaindata/index.md

@@ -0,0 +1,89 @@
+---
+title: "AnalyserNode: getFloatTimeDomainData() メソッド"
+short-title: getFloatTimeDomainData()
+slug: Web/API/AnalyserNode/getFloatTimeDomainData
+l10n:
+  sourceCommit: 135b8311a5e3d12789e8421845be3ce026ef72b8
+---
+
+{{ APIRef("Web Audio API") }}
+
+**`getFloatTimeDomainData()`** は {{domxref("AnalyserNode")}} 渡された　{{jsxref("Float32Array")}}　配列に、現在の波形、つまり時間領域のデータをコピーします。配列の各値はサンプルで、それぞれの時点における信号の大きさです。
+
+## 構文
+
+```js-nolint
+getFloatTimeDomainData(array)
+```
+
+### 引数
+
+- `array`
+  - : 時間領域データのコピー先となる {{jsxref("Float32Array")}} です。
+    配列の持つ要素が {{domxref("AnalyserNode.fftSize")}} より少なかった場合、余分な要素は削除されます。必要以上の要素があった場合、余分な要素は無視されます。
+
+### 返値
+
+なし ({{jsxref("undefined")}})。
+
+## 例
+
+次の例では、 {{domxref("AudioContext")}} で `AnalyserNode` を作成し、 {{domxref("window.requestAnimationFrame()","requestAnimationFrame")}} と {{htmlelement("canvas")}} で時刻領域のデータを繰り返し収集し、現在の音声入力の「オシロスコープ」出力を描画する基本的な使用方法を示します。
+より完全な応用例/情報については、 [Voice-change-O-matic](https://github.com/mdn/webaudio-examples/tree/main/voice-change-o-matic) のデモを調べてください（関連するコードは [app.js の 108 ～ 193 行目](https://github.com/mdn/webaudio-examples/blob/main/voice-change-o-matic/scripts/app.js#L108-L193)を参照）。
+
+```js
+const audioCtx = new (window.AudioContext || window.webkitAudioContext)();
+const analyser = audioCtx.createAnalyser();
+
+// …
+
+analyser.fftSize = 1024;
+const bufferLength = analyser.fftSize;
+console.log(bufferLength);
+const dataArray = new Float32Array(bufferLength);
+
+canvasCtx.clearRect(0, 0, WIDTH, HEIGHT);
+
+function draw() {
+  drawVisual = requestAnimationFrame(draw);
+  analyser.getFloatTimeDomainData(dataArray);
+
+  canvasCtx.fillStyle = "rgb(200, 200, 200)";
+  canvasCtx.fillRect(0, 0, WIDTH, HEIGHT);
+  canvasCtx.lineWidth = 2;
+  canvasCtx.strokeStyle = "rgb(0, 0, 0)";
+  canvasCtx.beginPath();
+
+  const sliceWidth = (WIDTH * 1.0) / bufferLength;
+  let x = 0;
+
+  for (let i = 0; i < bufferLength; i++) {
+    const v = dataArray[i] * 200.0;
+    const y = HEIGHT / 2 + v;
+
+    if (i === 0) {
+      canvasCtx.moveTo(x, y);
+    } else {
+      canvasCtx.lineTo(x, y);
+    }
+    x += sliceWidth;
+  }
+
+  canvasCtx.lineTo(canvas.width, canvas.height / 2);
+  canvasCtx.stroke();
+}
+
+draw();
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ウェブオーディオ API の使用](/ja/docs/Web/API/Web_Audio_API/Using_Web_Audio_API)