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

ConstantSourceNode: offset property

· 52CE 我爱测

The read-only `offset` property of the ConstantSourceNode interface returns an AudioParam object indicating the numeric a-rate value which is always returned by the source when asked for the next sample.

Web Audio API

The read-only offset property of the ConstantSourceNode interface returns an AudioParam object indicating the numeric a-rate value which is always returned by the source when asked for the next sample.

[!NOTE] While the AudioParam named offset is read-only, the value property within is not. So you can change the value of offset by setting the value of ConstantSourceNode.offset.value:

myConstantSourceNode.offset.value = newValue;

Value

An AudioParam object indicating the a-rate value returned for every sample by this node. The default value is 1.0.

To access the offset parameter's current value, access the parameter's value property, as shown in the syntax box above.

Examples

This example shows how to set up a ConstantSourceNode so its offset is used as the input to a pair of GainNodes; this snippet is derived from the complete example you can find in Controlling multiple parameters with ConstantSourceNode.

gainNode2 = context.createGain();
gainNode3 = context.createGain();
gainNode2.gain.value = gainNode3.gain.value = 0.5;

volumeSliderControl.value = gainNode2.gain.value;

constantSource = context.createConstantSource();
constantSource.connect(gainNode2.gain);
constantSource.connect(gainNode3.gain);

First, the gain nodes are created and configured, and a slider control's value is set to match the gain on the two nodes. Then we create a new ConstantSourceNode and make it the source for the two gain nodes' GainNode.gain values. Each of those values is also an AudioParam.

Let's say we have an event handler (for Element/click_event events, in this case) which needs to respond by altering the value of the two gain nodes. With the linkage above in place, that can be done using this simple event handler:

function handleClickEvent(event) {
  constantSource.offset.value = volumeSliderControl.value;
}

All this function has to do is fetch the current value of the slider control we're using to control the paired nodes' gains, then store that value into the ConstantSourceNode's offset parameter. That's done by changing the contents of its AudioParam.value property. The two gain nodes quickly adopt the new volume level.

Specifications

Browser compatibility

See also

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

资料来源与适用范围

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

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

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