PannerNode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Giao diện PannerNode định nghĩa một đối tượng xử lý âm thanh biểu diễn vị trí, hướng và hành vi của tín hiệu nguồn âm thanh trong không gian vật lý mô phỏng. AudioNode này sử dụng hệ tọa độ Descartes tay phải để mô tả vị trí của nguồn dưới dạng vectơ và hướng của nó dưới dạng hình nón 3D.
Một PannerNode luôn có đúng một đầu vào và một đầu ra: đầu vào có thể là mono hoặc stereo nhưng đầu ra luôn là stereo (2 kênh); bạn không thể tạo hiệu ứng phân bố âm thanh mà không có ít nhất hai kênh âm thanh!
| Số đầu vào | 1 |
|---|---|
| Số đầu ra | 1 |
| Chế độ đếm kênh | "clamped-max" |
| Số kênh | 2 |
| Diễn giải kênh | "speakers" |
Hàm khởi tạo
PannerNode()-
Tạo một phiên bản đối tượng
PannerNodemới.
Thuộc tính phiên bản
Kế thừa các thuộc tính từ lớp cha, AudioNode.
Note:
Giá trị hướng và vị trí được đặt và truy xuất bằng cú pháp khác nhau, vì chúng được lưu trữ dưới dạng giá trị AudioParam. Truy xuất được thực hiện bằng cách truy cập, ví dụ PannerNode.positionX. Trong khi đó, để đặt cùng thuộc tính, ta dùng PannerNode.positionX.value. Đây là lý do các giá trị này không được đánh dấu là chỉ đọc, dù chúng xuất hiện như vậy trong WebIDL.
PannerNode.coneInnerAngle-
Giá trị double mô tả góc, tính bằng độ, của hình nón bên trong mà ở đó không có sự giảm âm lượng.
PannerNode.coneOuterAngle-
Giá trị double mô tả góc, tính bằng độ, của hình nón bên ngoài mà ở đó âm lượng sẽ giảm đi một lượng không đổi, được xác định bởi thuộc tính
coneOuterGain. PannerNode.coneOuterGain-
Giá trị double mô tả mức giảm âm lượng bên ngoài hình nón được xác định bởi thuộc tính
coneOuterAngle. Giá trị mặc định là0, nghĩa là không có âm thanh nào được nghe thấy. PannerNode.distanceModel-
Giá trị liệt kê xác định thuật toán nào được dùng để giảm âm lượng của nguồn âm thanh khi nó di chuyển xa người nghe. Các giá trị có thể là
"linear","inverse"và"exponential". Giá trị mặc định là"inverse". PannerNode.maxDistance-
Giá trị double biểu diễn khoảng cách tối đa giữa nguồn âm thanh và người nghe, sau khoảng cách đó âm lượng không giảm thêm nữa.
PannerNode.orientationX-
Biểu diễn vị trí ngang của vectơ nguồn âm thanh trong hệ tọa độ Descartes tay phải. Mặc dù không thể thay đổi trực tiếp
AudioParamnày, giá trị của nó có thể được thay đổi thông qua thuộc tínhvalue. Giá trị mặc định là 1. PannerNode.orientationY-
Biểu diễn vị trí dọc của vectơ nguồn âm thanh trong hệ tọa độ Descartes tay phải. Mặc dù không thể thay đổi trực tiếp
AudioParamnày, giá trị của nó có thể được thay đổi thông qua thuộc tínhvalue. Giá trị mặc định là 0. PannerNode.orientationZ-
Biểu diễn vị trí theo chiều dọc (tiến lùi) của vectơ nguồn âm thanh trong hệ tọa độ Descartes tay phải. Mặc dù không thể thay đổi trực tiếp
AudioParamnày, giá trị của nó có thể được thay đổi thông qua thuộc tínhvalue. Giá trị mặc định là 0. PannerNode.panningModel-
Giá trị liệt kê xác định thuật toán không gian hóa nào được dùng để định vị âm thanh trong không gian 3D.
PannerNode.positionX-
Biểu diễn vị trí ngang của âm thanh trong hệ tọa độ Descartes tay phải. Mặc dù không thể thay đổi trực tiếp
AudioParamnày, giá trị của nó có thể được thay đổi thông qua thuộc tínhvalue. Giá trị mặc định là 0. PannerNode.positionY-
Biểu diễn vị trí dọc của âm thanh trong hệ tọa độ Descartes tay phải. Mặc dù không thể thay đổi trực tiếp
AudioParamnày, giá trị của nó có thể được thay đổi thông qua thuộc tínhvalue. Giá trị mặc định là 0. PannerNode.positionZ-
Biểu diễn vị trí theo chiều sâu (tiến lùi) của âm thanh trong hệ tọa độ Descartes tay phải. Mặc dù không thể thay đổi trực tiếp
AudioParamnày, giá trị của nó có thể được thay đổi thông qua thuộc tínhvalue. Giá trị mặc định là 0. PannerNode.refDistance-
Giá trị double biểu diễn khoảng cách tham chiếu để giảm âm lượng khi nguồn âm thanh di chuyển xa người nghe hơn. Với khoảng cách lớn hơn giá trị này, âm lượng sẽ giảm dựa trên
rolloffFactorvàdistanceModel. PannerNode.rolloffFactor-
Giá trị double mô tả tốc độ giảm âm lượng khi nguồn di chuyển xa người nghe. Giá trị này được dùng bởi tất cả các mô hình khoảng cách.
Phương thức phiên bản
Kế thừa các phương thức từ lớp cha, AudioNode.
PannerNode.setPosition()Deprecated-
Xác định vị trí của nguồn âm thanh tương đối với người nghe (được biểu diễn bởi đối tượng
AudioListenerđược lưu trong thuộc tínhBaseAudioContext.listener). PannerNode.setOrientation()Deprecated-
Xác định hướng phát của nguồn âm thanh.
Ví dụ
Xem BaseAudioContext.createPanner() để có mã ví dụ.
Thông số kỹ thuật
| Specification |
|---|
| Web Audio API # PannerNode |