AudioData: метод copyTo()

Метод copyTo() интерфейса AudioData копирует плоскость объекта AudioData в буфер назначения.

destination

ArrayBuffer, TypedArray или DataView для копирования плоскости.

options

Объект, содержащий следующее:

planeIndex

Индекс плоскости для копирования.

frameOffset Необязательно

Целое число, задающее смещение в данных плоскости, указывающее, с какой плоскости начать копирование. По умолчанию 0.

frameCount Необязательно

Целое число, задающее количество кадров для копирования. Если опущено, копируются все кадры плоскости, начиная с кадра, указанного в frameOffset.

Неопределено.

InvalidStateError DOMException

Выбрасывается, если объект AudioData был передан.

RangeError

Выбрасывается, если выполняется одно из следующих условий:

• Длина образца больше длины назначения.
• Формат объекта AudioData описывает плоский формат, но options.planeIndex выходит за пределы числа доступных плоскостей.
• Формат объекта AudioData описывает чередующийся формат, но options.planeIndex больше, чем 0.

В следующем примере копируется плоскость с индексом 1 в буфер назначения.

AudioData.copyTo(AudioBuffer, { planeIndex: 1 });