PannerNode: positionY property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
Thuộc tính positionY của giao diện PannerNode xác định tọa độ Y của vị trí nguồn âm thanh trong tọa độ Descartes 3D, tương ứng với trục dọc (trên-dưới). Vectơ đầy đủ
được xác định bởi vị trí của nguồn âm thanh, được đưa ra dưới dạng
(positionX, positionY, positionZ), và hướng
của nguồn âm thanh (tức là hướng mà nó đang đối mặt), được đưa ra dưới dạng
(orientationX,
orientationY,
orientationZ).
Tùy thuộc vào tính định hướng của âm thanh (được chỉ định bằng các thuộc tính
coneInnerAngle,
coneOuterAngle, và
codeOuterGain), hướng của
âm thanh có thể thay đổi âm lượng cảm nhận được khi nó đang phát. Nếu âm thanh
đang hướng về phía người nghe, nó sẽ to hơn so với khi âm thanh hướng ra xa
người nghe.
AudioParam chứa trong thuộc tính này là chỉ đọc; tuy nhiên bạn
vẫn có thể thay đổi giá trị của tham số bằng cách gán giá trị mới cho thuộc tính
AudioParam.value của nó.
Giá trị
Một AudioParam có value là tọa độ Y của vị trí
nguồn âm thanh, trong tọa độ Descartes 3D.
Ví dụ
Ví dụ sau khởi động một bộ dao động và dịch chuyển nó lên trên so với người nghe sau 1 giây, xuống dưới sau 2 giây, và về giữa sau 3 giây. Lưu ý rằng trong trường hợp này, sự thay đổi chủ yếu ảnh hưởng đến âm sắc của bộ dao động, vì đây là sóng mono đơn giản.
const context = new AudioContext();
const osc = new OscillatorNode(context);
const panner = new PannerNode(context);
panner.panningModel = "HRTF";
panner.positionY.setValueAtTime(1, context.currentTime + 1);
panner.positionY.setValueAtTime(-1, context.currentTime + 2);
panner.positionY.setValueAtTime(0, context.currentTime + 3);
osc.connect(panner).connect(context.destination);
osc.start(0);
Thông số kỹ thuật
| Specification |
|---|
| Web Audio API # dom-pannernode-positiony |