mapleafgo
788327047c
核心变更: - 实现全局 oto.Context 单例管理（sync.Once） - 实现一次性播放：PlayWav/PlayMP3（支持 context 取消） - 实现 BGM 循环播放：PlayMP3Loop（atomic.Bool + WaitGroup） - 迁移所有业务层到新 API（TTS/BGM/待机音频） - 添加完整的单元测试（6/6 通过） 技术栈: - oto/v3 v3.3.2（低级音频播放） - hajimehoshi/go-mp3 v0.3.4（MP3 解码） - youpy/go-wav v0.3.2（WAV 解码） 移除依赖: - gopxl/beep/v2 及所有相关依赖 优化: - 流式播放，无需预先加载 - 并发安全，无竞态条件 - 资源管理清晰（defer cleanup） - Sleep 间隔优化（1ms → 10ms，降低 CPU 占用）
28 lines
773 B
Go
28 lines
773 B
Go
// Package audio 提供基于 oto/v3 的音频播放功能。
|
|
//
|
|
// 播放模式:
|
|
// - 一次性播放: PlayWav(), PlayMP3() - 阻塞直到完成或 context 取消
|
|
// - 循环播放: PlayMP3Loop() - 非阻塞,返回 player 和清理函数
|
|
//
|
|
// 使用示例:
|
|
//
|
|
// // 一次性播放 WAV
|
|
// err := audio.PlayWav(ctx, wavReader)
|
|
// if err != nil && !errors.Is(err, context.Canceled) {
|
|
// log.Printf("播放失败: %v", err)
|
|
// }
|
|
//
|
|
// // 循环播放 MP3
|
|
// player, cleanup, err := audio.PlayMP3Loop(mp3Reader)
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
// defer cleanup()
|
|
// // ... 播放中 ...
|
|
//
|
|
// 资源管理:
|
|
// - 一次性播放: 函数内部自动管理所有资源
|
|
// - 循环播放: 调用者必须调用 defer cleanup() 清理资源
|
|
//
|
|
package audio
|