AudioBufferSourceNode

Constructor

AudioBufferSourceNode()

Tạo và trả về một đối tượng AudioBufferSourceNode mới. Ngoài ra, bạn có thể dùng phương thức factory BaseAudioContext.createBufferSource(); xem Tạo một AudioNode.

Thuộc tính thể hiện

Kế thừa các thuộc tính từ đối tượng cha của nó, AudioScheduledSourceNode.

AudioBufferSourceNode.buffer

Một AudioBuffer xác định tài nguyên âm thanh sẽ được phát, hoặc khi được đặt thành giá trị null, xác định một kênh im lặng duy nhất (trong đó mọi mẫu đều là 0.0).

AudioBufferSourceNode.detune

Một AudioParam k-rate biểu diễn độ lệch tần trong đơn vị cent. Giá trị này được kết hợp với playbackRate để xác định tốc độ phát âm thanh. Giá trị mặc định là 0 (nghĩa là không lệch tần), và phạm vi danh định là từ -∞ đến ∞.

AudioBufferSourceNode.loop

Một thuộc tính Boolean cho biết tài nguyên âm thanh có phải được phát lại khi chạm tới cuối AudioBuffer hay không. Giá trị mặc định của nó là false.

AudioBufferSourceNode.loopStart Optional

Một giá trị dấu phẩy động cho biết thời điểm, tính bằng giây, mà tại đó việc phát AudioBuffer phải bắt đầu khi loop là true. Giá trị mặc định của nó là 0 (nghĩa là ở đầu mỗi vòng lặp, việc phát bắt đầu từ đầu bộ đệm âm thanh).

AudioBufferSourceNode.loopEnd Optional

Một số dấu phẩy động cho biết thời điểm, tính bằng giây, mà tại đó việc phát AudioBuffer dừng lại và lặp trở về thời điểm được chỉ ra bởi loopStart, nếu loop là true. Giá trị mặc định là 0.

AudioBufferSourceNode.playbackRate

Một AudioParam k-rate xác định hệ số tốc độ mà tại đó tài nguyên âm thanh sẽ được phát, trong đó giá trị 1.0 là tốc độ lấy mẫu tự nhiên của âm thanh. Vì đầu ra không áp dụng hiệu chỉnh cao độ, thuộc tính này có thể được dùng để thay đổi cao độ của mẫu. Giá trị này được kết hợp với detune để xác định tốc độ phát cuối cùng.

Phương thức thể hiện

Kế thừa các phương thức từ đối tượng cha của nó, AudioScheduledSourceNode, và ghi đè phương thức sau:.

start()

Lên lịch phát dữ liệu âm thanh chứa trong bộ đệm, hoặc bắt đầu phát ngay lập tức. Đồng thời cũng cho phép đặt độ lệch bắt đầu và thời lượng phát.

Ví dụ

Trong ví dụ này, chúng ta tạo một bộ đệm dài hai giây, điền nhiễu trắng vào đó, rồi phát nó bằng AudioBufferSourceNode. Các chú thích sẽ giải thích rõ điều gì đang diễn ra.

const audioCtx = new AudioContext();

// Create an empty three-second stereo buffer at the sample rate of the AudioContext
const myArrayBuffer = audioCtx.createBuffer(
  2,
  audioCtx.sampleRate * 3,
  audioCtx.sampleRate,
);

// Fill the buffer with white noise;
// just random values between -1.0 and 1.0
for (let channel = 0; channel < myArrayBuffer.numberOfChannels; channel++) {
  // This gives us the actual ArrayBuffer that contains the data
  const nowBuffering = myArrayBuffer.getChannelData(channel);
  for (let i = 0; i < myArrayBuffer.length; i++) {
    // Math.random() is in [0; 1.0]
    // audio needs to be in [-1.0; 1.0]
    nowBuffering[i] = Math.random() * 2 - 1;
  }
}

// Get an AudioBufferSourceNode.
// This is the AudioNode to use when we want to play an AudioBuffer
const source = audioCtx.createBufferSource();
// set the buffer in the AudioBufferSourceNode
source.buffer = myArrayBuffer;
// connect the AudioBufferSourceNode to the
// destination so we can hear the sound
source.connect(audioCtx.destination);
// start the source playing
source.start();

Thông số kỹ thuật

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

Xem thêm

• Sử dụng Web Audio API
• Web Audio API