AudioScheduledSourceNode: phương thức start()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
Phương thức start() của AudioScheduledSourceNode lên lịch để một âm thanh bắt đầu phát tại thời điểm được chỉ định.
Nếu không chỉ định thời gian, âm thanh sẽ bắt đầu phát ngay lập tức.
Cú pháp
start()
start(when)
Tham số
whenOptional-
Thời điểm, tính bằng giây, mà âm thanh sẽ bắt đầu phát. Giá trị này được chỉ định trong cùng hệ tọa độ thời gian mà
AudioContextdùng cho thuộc tínhcurrentTimecủa nó. Giá trị0(hoặc bỏ qua hoàn toàn tham sốwhen) sẽ làm âm thanh bắt đầu phát ngay lập tức.
Giá trị trả về
Không có (undefined).
Ngoại lệ
InvalidStateNodeDOMException-
Được ném ra nếu nút đã được khởi động trước đó. Lỗi này xảy ra ngay cả khi nút không còn chạy nữa do một lần gọi trước đó tới
stop(). RangeError-
Được ném ra nếu giá trị được chỉ định cho
whenlà số âm.
Ví dụ
Ví dụ này minh họa cách tạo một OscillatorNode được lên lịch để bắt đầu phát sau 2 giây và dừng phát sau đó 1 giây. Các mốc thời gian được tính bằng cách cộng số giây mong muốn vào dấu thời gian hiện tại của ngữ cảnh trả về bởi AudioContext.currentTime.
context = new AudioContext();
osc = context.createOscillator();
osc.connect(context.destination);
/* Lên lịch thời điểm bắt đầu và dừng cho bộ dao động */
osc.start(context.currentTime + 2);
osc.stop(context.currentTime + 3);
Thông số kỹ thuật
| Specification |
|---|
| Web Audio API # dom-audioscheduledsourcenode-start |