Go beep Seq与Mix的声音组合有什么区别

我第一次把多个音频源接到 beep 播放器时，最容易混淆的就是 Seq 和 Mix：它们都接收多个 Streamer，但解决的不是同一类问题。简单记忆即可：需要一段播完再播下一段，用 beep.Seq；需要多个声音同时存在，用 beep.Mix。

官方文档：https://pkg.go.dev/github.com/gopxl/beep

先看声音是“排队”还是“同场”

beep.Seq(a, b, c) 的核心是时间上的先后：先把 a 播完，再从 b 继续，最后处理 c。官方描述是按顺序逐个流出，且中间不主动插入暂停。因此它很适合播放列表、语音段落、片头加正文这类“前一个结束后才轮到下一个”的组合。

beep.Mix(a, b, c) 则把多个 Streamer 的样本混在一起输出，听感上是同一时刻的多个声部。它适合背景音乐和提示音重叠、左右声道素材同时存在，或把多条独立音轨交给同一播放出口。下面的关系图只表达两种组合器的静态职责，不是运行截图。

我会按这三个场景做选择

如果需求是“播完欢迎语再播操作说明”，我会先选 Seq。它表达了业务上的顺序，调用者不需要自己监听前一个流何时结束：

package main

import "github.com/gopxl/beep"

func makeAnnouncement(intro, detail beep.Streamer) beep.Streamer {
	// 两段语音按传入顺序衔接，不在中间人为插入静音。
	return beep.Seq(intro, detail)
}

如果需求是“音乐继续播放，同时短提示音响起”，我会选 Mix。提示音结束后，混合流仍可以继续由背景音乐提供样本：

package main

import "github.com/gopxl/beep"

func makeNotification(background, effect beep.Streamer) beep.Streamer {
	// 两条 Streamer 同时进入组合器，表达背景与提示音的重叠关系。
	return beep.Mix(background, effect)
}

需要注意，Seq 和 Mix 都是组合器，不是播放器；最后仍要把返回的 Streamer 交给你的播放、编码或后续效果链。若要动态增删声源，官方文档还提供了 beep.Mixer，它的职责与一次性调用 Mix 不同，更适合运行期间调用 Add。

采样率和错误处理是容易漏掉的边界

混音前不能只看“都是 Streamer”。官方文档说明，播放器通常有固定采样率；如果输入流的采样率不同，直接播放可能导致速度和音高变化。需要混合时，先把输入转换到同一个目标采样率，再交给 Mix：

package main

import (
	"github.com/gopxl/beep"
)

func normalizeForMix(source beep.Streamer, sourceRate, targetRate beep.SampleRate) beep.Streamer {
	// 只有采样率不同才做转换，目标采样率应与播放出口保持一致。
	if sourceRate == targetRate {
		return source
	}
	// 质量值越高通常越耗 CPU；在线播放可从较小的合法值开始选择。
	return beep.Resample(3, sourceRate, targetRate, source)
}

另一个容易误判的地方是错误：文档明确写出 Seq 和 Mix 都不会传播子流错误。也就是说，不能把组合器的行为当成完整的错误汇总器；解码器、文件流或网络流的错误处理，要在对应资源的生命周期里设计。图2把“采样率统一”和“错误边界”放在组合器外侧，提醒我不要把格式转换和播放控制混成一个职责。

用约束而不是功能数量做最后决定

我的经验是：先问“这几个声音是否应该在同一个时间窗口里出现”，再决定 API。答案为“否”时用 Seq，答案为“是”时用 Mix；如果声源还会在播放过程中动态变化，就把视线移到 beep.Mixer。这样比背函数名更不容易在需求变更后选错。

常见问题

Seq 会不会在两个音频之间自动加一小段静音？

不会。官方文档描述的是逐个流出且不带暂停；需要间隔时，应显式加入静音流或其他有时长的 Streamer。

Mix 能不能替代动态 Mixer？

一次性组合固定声源时可以用 Mix。如果播放期间要持续添加或清空声源，使用 beep.Mixer 的动态接口更贴合需求。

两个函数都不传播错误，该怎么理解？

组合器不会替你把子流错误汇总到组合结果上。解码、文件或网络资源应在创建和管理它们的代码边界中处理，不能只依赖 Seq 或 Mix 的返回值。