AudioData: copyTo() 方法
注意：此功能在 專用 Web Workers 中可用。
AudioData 介面的 copyTo() 方法會將 AudioData 物件的一個聲道複製到目標緩衝區。
語法
js
copyTo(destination, options)
引數
destination-
要將聲道複製到的
ArrayBuffer、TypedArray或DataView。 options-
一個包含以下內容的 *)
planeIndex-
要從中複製聲道的索引。
frameOffset可選-
一個整數，表示聲道資料中的偏移量，指示從哪個聲道開始複製。預設為
0。 frameCount可選-
要複製的幀數。如果省略，則將複製聲道中的所有幀，從
frameOffset指定的幀開始。
返回值
Undefined。
異常
InvalidStateErrorDOMException-
如果
AudioData物件已被轉移，則丟擲此異常。 RangeError-
如果滿足以下任一條件，則丟擲錯誤
- 樣本的長度大於目標長度。
AudioData物件的格式描述為聲道格式，但options.planeIndex超出了可用聲道的數量。AudioData物件的格式描述為交錯格式，但options.planeIndex大於0。
示例
以下示例將索引為 1 的聲道複製到目標緩衝區。
js
AudioData.copyTo(AudioBuffer, { planeIndex: 1 });
規範
| 規範 |
|---|
| WebCodecs # dom-audiodata-copyto |
瀏覽器相容性
載入中…