Files
game-driver/pkg/tts/aliyun.go
mapleafgo e4c34f0eec refactor(tts): TTS 极简重构与代码质量提升
## 核心改进

### TTS 模块重构
- 统一 API,仅保留 Sound(ctx, text) 方法
- 优化日志,添加 [TTS] 前缀和结构化字段
- 实现互斥等待:同时只播放一个,新请求等待旧播放完成
- 响应 context 取消:超时或断开时立即停止播放
- 移除全局 context 存储,改为参数传递
- 简化实例化:New(config) 无需传入 context

### 代码质量提升
- 修复 PlayWav/PlayMP3 的死循环 bug(context 取消时缺少 return)
- 修复 standby_ctrl/pause.go 的忙循环(添加 Sleep 避免CPU 100%)
- 添加关键路径错误传播(only_video.go 不再忽略播放错误)
- 新增 pkg/errorsx/handler.go 统一错误处理工具

## 代码优化
- TTS 代码从 234 行精简到 166 行(减少 29%)
- 移除冗余状态管理(playing 标志、等待循环)
- 利用互斥锁的阻塞特性实现优雅等待
- 保持简洁易读的代码风格

## 行为说明
 同时只能播放一个 TTS(互斥)
 新请求等待当前播放完成(不打断)
 响应 context 取消(超时停止)
 日志完善,便于排查问题

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 14:05:16 +08:00

167 lines
3.8 KiB
Go

package tts
import (
"bytes"
"context"
"fmt"
"game-driver/config"
"game-driver/leaf"
"game-driver/pkg/audio"
"game-driver/pkg/errorsx"
"go.uber.org/zap"
"io"
"log"
"sync"
"time"
nls "github.com/aliyun/alibabacloud-nls-go-sdk"
)
// AliTTS 阿里云语音合成
// 同一时间只能播放一个 TTS
type AliTTS struct {
config.AliyunConfig
tokenResult nls.TokenResult
mu sync.Mutex // 互斥锁,确保同时只播放一个
}
type result struct {
Data io.ReadWriter
Error error
}
var DefaultTTS = &AliTTS{}
// onTaskFailed TTS 合成失败回调
func (tts *AliTTS) onTaskFailed(text string, param interface{}) {
p, _ := param.(*result)
p.Error = fmt.Errorf("语音合成异常: %v", text)
}
// onSynthesisResult TTS 合成数据回调
func (tts *AliTTS) onSynthesisResult(data []byte, param interface{}) {
p, _ := param.(*result)
p.Data.Write(data)
}
// Sound 播放 TTS
// 如果已有 TTS 在播放,会等待当前播放完成后再播放新的
func (tts *AliTTS) Sound(ctx context.Context, text string) {
if text == "" {
return
}
zap.S().Infof("[TTS] 开始播放: %s", text)
buf, err := tts.Get(ctx, text)
if err != nil {
zap.S().Errorw("[TTS] 合成失败", "text", text, "error", err)
return
}
size := buf.(*bytes.Buffer).Len()
zap.S().Debugf("[TTS] 合成成功: %s (%d字节)", text, size)
// 获取锁,阻塞等待直到可以播放
zap.S().Debugf("[TTS] 等待播放锁: %s", text)
tts.mu.Lock()
defer tts.mu.Unlock()
audio.PlayWav(ctx, buf)
// 检查是否被取消
if ctx.Err() != nil {
zap.S().Debugf("[TTS] 播放被取消: %s", text)
return
}
zap.S().Infof("[TTS] 播放完成: %s", text)
}
// getToken 获取阿里云 TTS Token
func (tts *AliTTS) getToken() error {
// Token 未过期则复用
if tts.tokenResult.ExpireTime != 0 && time.Unix(tts.tokenResult.ExpireTime, 0).After(time.Now()) {
return nil
}
tts.tokenResult = nls.TokenResult{}
resultMessage, err := nls.GetToken("cn-shanghai", "nls-meta.cn-shanghai.aliyuncs.com", tts.AccessKeyID, tts.AccessKeySecret, "2019-02-28")
if err != nil {
return err
}
if resultMessage.ErrMsg != "" {
zap.S().Errorf("[TTS] 获取Token失败: %s", resultMessage.ErrMsg)
return errorsx.ThirdPartyErr
}
tts.tokenResult = resultMessage.TokenResult
return nil
}
// Get 合成语音文本(内部方法)
func (tts *AliTTS) Get(ctx context.Context, text string) (io.Reader, error) {
param := nls.DefaultSpeechSynthesisParam()
param.Volume = tts.Volume
param.Voice = tts.Voice
param.SpeechRate = tts.SpeechRate
if err := tts.getToken(); err != nil {
return nil, err
}
connectConfig := nls.NewConnectionConfigWithToken(nls.DEFAULT_URL, tts.AppKey, tts.tokenResult.Id)
logger := nls.NewNlsLogger(leaf.DefaultWriter, "", log.LstdFlags|log.Ltime)
logger.SetLogSil(false)
logger.SetDebug(true)
ttsData := &result{
Data: &bytes.Buffer{},
}
synthesis, err := nls.NewSpeechSynthesis(
connectConfig, logger, false,
tts.onTaskFailed, tts.onSynthesisResult, nil,
nil, nil, ttsData,
)
if err != nil {
return ttsData.Data, err
}
defer synthesis.Shutdown()
ch, err := synthesis.Start(text, param, nil)
if err != nil {
return ttsData.Data, err
}
// 等待合成完成(带超时)
select {
case done := <-ch:
if !done {
zap.S().Error("[TTS] 合成失败: done=false")
return ttsData.Data, errorsx.ThirdPartyErr
}
size := ttsData.Data.(*bytes.Buffer).Len()
if size == 0 {
zap.S().Error("[TTS] 合成数据为空")
return ttsData.Data, errorsx.ThirdPartyErr
}
return ttsData.Data, nil
case <-time.After(time.Duration(tts.Timeout) * time.Second):
zap.S().Errorf("[TTS] 合成超时: %s", text)
return ttsData.Data, errorsx.DriverTimeoutErr
case <-ctx.Done():
return ttsData.Data, errorsx.DriverCancelErr
}
}
// New 创建 TTS 实例
func New(config config.AliyunConfig) *AliTTS {
return &AliTTS{
AliyunConfig: config,
}
}