Go beep 怎样把有限音频流包装为循环流

要让 Go beep 把一段有限音频反复播放，关键不是重复调用解码器，而是给 beep.Loop 一个能定位的 beep.StreamSeeker。最稳妥的做法是先把音频收进 beep.Buffer，再用 buffer.Streamer(0, buffer.Len()) 得到完整片段，最后调用 beep.Loop(-1, segment)。其中负数表示无限循环；真正播放时还应配合 beep.Take 或停止信号设置边界。

官方地址：https://pkg.go.dev/github.com/gopxl/beep/v2

先判断输入能否被 Loop 重置

beep 的 Streamer 只约定“按块提供双声道采样”，它可能在读完后永久结束；StreamSeeker 则额外提供总长度、当前位置和 Seek。循环的本质是回到片段起点，所以直接把网络流、一次性回调或已经耗尽的流传给 Loop，通常没有可重复的数据。

如果解码器本身实现了 StreamSeeker，可以直接使用；不确定时，把源读入 Buffer 更容易管理。下面的关系图只展示 API 的静态边界，不是运行截图或执行证据。

用 Buffer 固定有限片段，再创建循环流

Buffer.Streamer(from, to) 的区间包含 from、不包含 to，并返回 StreamSeeker。因此使用 0 到 Len() 可以明确覆盖整段已缓存音频。示例把循环限制为四遍，便于把无限循环改造成可验收的播放任务：

package main

import (
	"errors"
	"fmt"

	"github.com/gopxl/beep/v2"
)

func repeatFourTimes(buffer *beep.Buffer) (beep.Streamer, error) {
	// 空 Buffer 没有可循环的采样，先返回可读错误，避免得到无意义的流。
	if buffer == nil || buffer.Len() == 0 {
		return nil, errors.New("audio buffer is empty")
	}

	// Streamer 的右边界不包含 Len，正好覆盖 [0, Len) 的有限片段。
	segment := buffer.Streamer(0, buffer.Len())
	// 负数代表无限循环；这里用 Take 把消费边界收敛为四遍。
	loop := beep.Loop(-1, segment)
	limited := beep.Take(buffer.Len()*4, loop)
	return limited, nil
}

func report(stream beep.Streamer) {
	// 播放器把流读完后再读取 Err，才能发现底层解码或读取错误。
	if err := stream.Err(); err != nil {
		fmt.Println("stream error:", err)
	}
}

这里的 Take 以采样数而不是秒数设限；若采样率是 beep.SampleRate(44100)，一遍时长可以用 rate.D(buffer.Len()) 换算。需要固定时长时，先把目标时长换成采样数，再传给 Take，不要把“循环次数”和“播放秒数”混为一谈。

无限循环的停止、错误和资源边界

Loop(-1, segment) 本身没有自然终点。命令行程序可以用 Take 限制采样数，播放器场景则可以在收到取消信号后停止消费。若原始源是文件或网络解码器，它可能还实现了 StreamCloser；Loop 只接收 StreamSeeker，不会替你设计业务层的关闭时机，因此应由拥有原始资源的代码负责 Close。

错误也有边界：官方接口约定，错误发生后 Streamer 会耗尽，后续读取返回 0, false；Loop 会传播输入流错误，但只有消费完成或停止后检查 Err() 才能统一处理。不要用“循环还在响”推断底层没有错误。

值班式排查清单

回滚也很简单：先把 Loop(-1, segment) 替换成原始 segment，确认有限流能正常消费，再逐层恢复 Loop 和 Take。这样能区分是 Seek 能力、循环边界还是资源生命周期导致的问题。

常见问题

beep.Loop 的 count 传正数和负数有什么区别？

正数表示播放指定次数，负数表示无限循环。生产播放通常不建议裸用负数，最好再加停止条件。

为什么普通 Streamer 不能直接传给 Loop？

因为循环需要在片段边界重新定位；普通 Streamer 没有 Seek 和 Len，读完后无法保证从头再来。

Buffer.Streamer 的区间边界怎么理解？

它使用左闭右开区间 [from, to)，所以完整 Buffer 应写成 Streamer(0, buffer.Len())。