AudioData: phương thức copyTo()

Cú pháp

copyTo(destination, options)

Tham số

destination

Một ArrayBuffer, một TypedArray, hoặc một DataView để sao chép plane vào.

options

Một đối tượng chứa các thành phần sau:

planeIndex

Chỉ số của mặt phẳng cần sao chép từ đó.

frameOffset Optional

Một số nguyên cho biết độ lệch vào dữ liệu mặt phẳng, xác định bắt đầu sao chép từ khung mẫu nào. Mặc định là 0.

frameCount Optional

Một số nguyên cho biết số khung mẫu cần sao chép. Nếu bị bỏ qua thì tất cả khung mẫu trong mặt phẳng sẽ được sao chép, bắt đầu từ khung mẫu được chỉ định trong frameOffset.

Giá trị trả về

undefined.

Ngoại lệ

InvalidStateError DOMException

Được ném ra nếu đối tượng AudioData đã được chuyển giao.

RangeError

Được ném ra nếu một trong các điều kiện sau được đáp ứng:

• Độ dài của mẫu lớn hơn độ dài của đích.
• Định dạng của đối tượng AudioData mô tả một định dạng planar, nhưng options.planeIndex nằm ngoài số lượng mặt phẳng sẵn có.
• Định dạng của đối tượng AudioData mô tả một định dạng interleaved, nhưng options.planeIndex lớn hơn 0.

Ví dụ

Ví dụ sau sao chép mặt phẳng ở chỉ số 1 sang một bộ đệm đích.

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

Thông số kỹ thuật

Khả năng tương thích với trình duyệt