开源分享：TTS-Web-Vue系列 —— 批量转换功能的实现与优化-CSDN博客

本文链接：https://blog.csdn.net/hujian401387616/article/details/147545657

🎯 本文是TTS-Web-Vue系列的第二篇，主要介绍如何实现批量文本转语音功能。通过本文，您将了解到如何设计和实现一个高效、可靠的批量转换系统。

📖 系列文章导航

TTS-Web-Vue系列：打造最便捷的微软语音合成Web工具 - 项目介绍与整体架构
TTS-Web-Vue系列：批量转换功能的实现与优化 - 批量转换功能详解
更多文章持续更新中…

如果您是第一次接触本项目，建议先阅读第一篇文章，了解项目的基本情况和整体架构。本文将在此基础上，深入讲解批量转换功能的实现细节。

📚 功能概述

批量转换是TTS-Web-Vue的一个重要功能，它允许用户一次性转换多个文本文件为语音文件。主要特点包括：

支持多文件同时处理
实时显示转换进度
自动错误处理和恢复
支持断点续传
友好的用户界面反馈

🔧 技术实现

1. 任务创建和状态管理

批量转换的核心是任务管理系统，我们使用以下数据结构来管理任务：

interface BatchTask {
  inputKind: string;
  inputs: Array<{
    content: string;
  }>;
  properties: {
    wordBoundaryEnabled: boolean;
    outputFormat: string;
    concatenateResult: boolean;
    decompressOutputFiles: boolean;
  };
}

2. API设计

为了支持批量转换，我们设计了三个主要的API端点：

// 创建批量任务
async function createBatchTask(
  thirdPartyApi: string,
  tts88Key: string,
  task: BatchTask
): Promise<string>

// 获取任务状态
async function getBatchTaskStatus(
  thirdPartyApi: string,
  tts88Key: string,
  taskId: string
): Promise<BatchTaskStatus>

// 删除任务
async function deleteBatchTask(
  thirdPartyApi: string,
  tts88Key: string,
  taskId: string
): Promise<void>

3. 状态监控实现

我们实现了一个定期检查机制来监控任务状态：

const MAX_STATUS_CHECKS = 1200;  // 1小时内最多检查1200次
const CHECK_INTERVAL = 3000;     // 3秒检查一次
let checkCount = 0;

const checkStatus = async () => {
  if (checkCount >= MAX_STATUS_CHECKS) {
    throw new Error("任务执行超时");
  }
  
  const status = await getBatchTaskStatus(...);
  // 更新进度
  if (status.properties) {
    const total = status.properties.succeededAudioCount + status.properties.failedAudioCount;
    const completed = status.properties.succeededAudioCount;
    this.batchProgress = total > 0 ? Math.round((completed / total) * 100) : 0;
  }
  
  // 处理不同状态
  switch (status.status) {
    case "Running":
      setTimeout(checkStatus, CHECK_INTERVAL);
      break;
    case "Succeeded":
      handleSuccess();
      break;
    case "Failed":
      handleError();
      break;
  }
};

4. 错误处理机制

我们实现了完善的错误处理机制：

try {
  // 验证API配置
  if (!this.config.thirdPartyApi || !this.config.tts88Key) {
    throw new Error("请先配置TTS88 API地址和密钥");
  }

  // 验证文件列表
  const pendingFiles = this.tableData.filter((item: any) => item.status !== "done");
  if (pendingFiles.length === 0) {
    throw new Error("没有需要转换的文件");
  }

  // 处理每个文件的错误
  for (const file of pendingFiles) {
    try {
      // 处理单个文件
    } catch (err) {
      file.status = "error";
      file.error = String(err);
    }
  }
} catch (err) {
  // 全局错误处理
  console.error("批量转换失败:", err);
  ElMessage({
    message: "批量转换失败: " + String(err),
    type: "error",
    duration: 3000,
  });
}

🌟 优化策略

1. 性能优化

批量处理：使用Promise.all并发处理多个文件
状态缓存：缓存文件状态，避免重复转换
资源释放：及时清理不需要的音频资源

2. 用户体验优化

进度显示：实时显示整体转换进度
状态反馈：清晰的成功/失败状态展示
错误提示：友好的错误信息展示

3. 可靠性优化

断点续传：支持从失败处继续转换
超时处理：设置合理的超时时间
重试机制：失败任务自动重试

📈 使用示例

// 创建批量转换任务
const task = {
  inputKind: "SSML",
  inputs: files.map(file => ({
    content: generateSSML(file.content)
  })),
  properties: {
    wordBoundaryEnabled: true,
    outputFormat: "audio-16khz-128kbitrate-mono-mp3"
  }
};

// 发送任务请求
const taskId = await createBatchTask(apiUrl, apiKey, task);

// 监控任务状态
checkStatus(taskId);