PannerNode: positionX 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 positionX của giao diện PannerNode xác định tọa độ X của vị trí nguồn âm thanh trong tọa độ Descartes 3D, tương ứng với trục ngang (trái-phả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 độ X của vị trí
nguồn âm thanh, trong tọa độ Descartes 3D. Giá trị mặc định là 0.
Ví dụ
Ví dụ sau khởi động một bộ dao động và dịch chuyển nó sang trái sau 1 giây, sang phải sau 2 giây, và về giữa sau 3 giây.
const context = new AudioContext();
const osc = new OscillatorNode(context);
const panner = new PannerNode(context);
panner.positionX.setValueAtTime(-1, context.currentTime + 1);
panner.positionX.setValueAtTime(1, context.currentTime + 2);
panner.positionX.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-positionx |