Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The copyTo()
method of the AudioData
interface copies a plane of an AudioData
object to a destination buffer.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The copyTo()
method of the AudioData
interface copies a plane of an AudioData
object to a destination buffer.
js
copyTo(destination, options)
destination
An ArrayBuffer
, a TypedArray
, or a DataView
to copy the plane to.
options
An object containing the following:
planeIndex
The index of the plane to copy from.
frameOffset
Optional
An integer giving an offset into the plane data indicating which plane to begin copying from. Defaults to 0
.
frameCount
Optional
An integer giving the number of frames to copy. If omitted then all frames in the plane will be copied, beginning with the frame specified in frameOffset
.
Undefined.
InvalidStateError
DOMException
Thrown if the AudioData
object has been transferred.
RangeError
Thrown if one of the following conditions is met:
AudioData
object describes a planar format, but options.planeIndex
is outside of the number of planes available.AudioData
object describes an interleaved format, but options.planeIndex
is greater than 0
.The following example copies the plane at index 1
to a destination buffer.
js
AudioData.copyTo(AudioBuffer, { planeIndex: 1 });
Specification |
---|
WebCodecs # dom-audiodata-copyto |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
copyTo |
94 | 94 | No | No | 80 | No | 94 | 94 | No | 66 | No | 17.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioData/copyTo