Tone.js音频播放控制：如何正确停止采样器播放

在音频编程中，控制音频的播放和停止是基础但至关重要的功能。本文将深入探讨如何在Tone.js中正确控制采样器(Sampler)的播放和停止操作。

问题背景

在使用Tone.js的Sampler进行音频播放时，开发者通常会使用triggerAttackRelease方法来触发音频播放。这个方法接收两个主要参数：音频频率和持续时间。然而，当需要在中途强制停止音频播放时，简单的调用triggerAttackRelease并不能达到预期效果。

正确的停止方法

Tone.js为Sampler提供了专门的停止方法：

1. releaseAll()方法
   这是停止Sampler播放最直接有效的方式。调用sampler.releaseAll()会立即释放所有正在播放的音符，实现音频的即时停止。

2. dispose()方法
   如果需要彻底释放Sampler资源，可以使用dispose()方法。但要注意这会完全销毁Sampler实例，之后无法再次使用。

实现示例

class AudioPlayer {
  private sampler: Tone.Sampler | null = null;

  // 初始化Sampler
  public async init() {
    this.sampler = new Tone.Sampler({
      urls: {
        A0: "A0.mp3",
        C1: "C1.mp3",
        // 其他采样...
      },
      release: 1,
      baseUrl: "/samples/"
    }).toDestination();
    await Tone.loaded();
  }

  // 播放音符
  public play(midi: number, durationInSeconds: number) {
    const frequency = Tone.Midi(midi).toFrequency();
    this.sampler?.triggerAttackRelease(frequency, durationInSeconds);
  }

  // 停止所有播放
  public stop() {
    this.sampler?.releaseAll();
  }
}

注意事项

1. 音频缓冲
   使用Sampler前确保所有音频样本已加载完成，可通过Tone.loaded()Promise来确保。

2. 资源管理
   在不需要Sampler时，应当调用dispose()释放资源，避免内存泄漏。

3. 平滑过渡
   可以通过设置适当的release参数值来实现音频停止时的自然衰减，避免生硬的切断。

高级控制

对于更复杂的音频控制场景，Tone.js还提供了：

• 单独控制每个音符的释放
• 音量渐变控制
• 播放速率调整
• 效果器链处理

掌握这些音频控制技术对于开发交互式音乐应用、游戏音效系统等场景至关重要。正确使用停止方法不仅能提升用户体验，还能优化应用性能。