大网数据广告活动
Web 标准与前端开发

PannerNode: PannerNode() constructor

· 52CE 我爱测

The **`PannerNode()`** constructor of the Web Audio API creates a new PannerNode object instance.

Web Audio API

The PannerNode() constructor of the Web Audio API creates a new PannerNode object instance.

Syntax

new PannerNode(context)
new PannerNode(context, options)

Parameters

  • context
    • : A BaseAudioContext representing the audio context you want the node to be associated with.
  • options
    • : A PannerOptions dictionary object defining the properties you want the PannerNode to have:
      • panningModel
        • : The PannerNode.panningModel you want the PannerNode to have (the default is equalpower.)
      • distanceModel
        • : The PannerNode.distanceModel you want the PannerNode to have (the default is inverse.)
      • positionX
        • : The PannerNode.positionX you want the PannerNode to have (the default is 0.)
      • positionY
        • : The PannerNode.positionY you want the PannerNode to have (the default is 0.)
      • positionZ
        • : The PannerNode.positionZ you want the PannerNode to have (the default is 0.)
      • orientationX
        • : The PannerNode.orientationX you want the PannerNode to have (the default is 1.)
      • orientationY
        • : The PannerNode.orientationY you want the PannerNode to have (the default is 0.)
      • orientationZ
        • : The PannerNode.orientationZ you want the PannerNode to have (the default is 0.)
      • refDistance
        • : The PannerNode.refDistance you want the PannerNode to have. The default is 1, and negative values are not allowed.
      • maxDistance
        • : The PannerNode.maxDistance you want the PannerNode to have. The default is 10000, and non-positive values are not allowed.
      • rolloffFactor
        • : The PannerNode.rolloffFactor you want the PannerNode to have. The default is 1, and negative values are not allowed.
      • coneInnerAngle
        • : The PannerNode.coneInnerAngle you want the PannerNode to have (the default is 360.)
      • coneOuterAngle
        • : The PannerNode.coneOuterAngle you want the PannerNode to have (the default is 360.)
      • coneOuterGain
        • : The PannerNode.coneOuterGain you want the PannerNode to have. The default is 0, and its value can be in the range 0–1.
      • channelCount
        • : Represents an integer used to determine how many channels are used when up-mixing and down-mixing connections to any inputs to the node. (See AudioNode.channelCount for more information.) Its usage and precise definition depend on the value of channelCountMode.
      • channelCountMode
        • : Represents an enumerated value describing the way channels must be matched between the node's inputs and outputs. (See AudioNode.channelCountMode for more information including default values.)
      • channelInterpretation
        • : Represents an enumerated value describing the meaning of the channels. This interpretation will define how audio up-mixing and down-mixing will happen. The possible values are "speakers" or "discrete". (See AudioNode.channelCountMode for more information including default values.)

Exceptions

  • RangeError
    • : Thrown if the refDistance, maxDistance, or rolloffFactor properties have been given a value that is outside the accepted range.
  • InvalidStateError DOMException
    • : Thrown if the coneOuterGain property has been given a value outside the accepted range (0–1).

Examples

const ctx = new AudioContext();

const options = {
  positionX: 1,
  maxDistance: 5000,
};

const myPanner = new PannerNode(ctx, options);

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。