Edge TTS

边缘-TT

Edge-TTS是Microsoft Edge的文本到语音（TTS）服务的快速实现。该库提供了一个简单易用的API接口，使开发人员可以将高质量的文本对语音功能无缝整合到Apple Platform应用程序中。

日本语ドキュメント| 中文文档| 한국어한국어

特征

多种声音和语言

• 超过400个神经网络声音
• 支持100多种语言和区域变体
• 自然语音综合效应

灵活的语音控制

• 可调语音率（-50％至 +100％）
• 音高控制（-50Hz至 +50Hz）
• 音量控制（-50％至 +50％）
• 边界类型选择（句子/单词）

丰富的输出选项

• 支持MP3格式导出
• 实时语音综合流
• 异步转换和播放
• 可选的JSON元数据导出
• 可选的SRT字幕导出
• 跨平台文件导出支持（iOS/MACOS）

开发工具

• 用于快速测试和批处理处理的命令行工具
• 带有视觉配置的本机GUI应用
• 详细的API文档和用法示例

跨平台兼容性

• MacOS 13.0+
• iOS/iPados 15.0+

安装

Swift软件包管理器

将以下依赖项添加到您的软件包。Swift文件：

dependencies: [
    . package ( url : " https://github.com/brewusinc/edge-tts.git " , from : " 1.0.0 " )
] 

快速开始

基本用法

import EdgeTTS

// Create TTS instance
let tts = EdgeTTS ( config : Configure (
    voice : " en-US-JennyNeural " ,
    rate : " +0% " ,
    pitch : " +0Hz " ,
    volume : " +0% " ,
    saveJSON : true ,  // Enable JSON metadata export
    saveSRT : true ,   // Enable SRT subtitle export
    boundaryType : . sentence  // Use sentence boundary (.word for word boundary)
) )

// Async conversion
Task {
    do {
        try await tts . ttsPromise ( text : " Hello, World! " , audioPath : " output.mp3 " )
        print ( " Conversion completed " )
    } catch {
        print ( " Conversion failed: ( error ) " )
    }
}

命令行工具用法

CLI工具提供了两个主要命令： list和speak 。

列表可用的声音

 # List all available voices
edge-tts-cli list

# List voices with proxy
edge-tts-cli list --proxy http://host:port

将文字转换为语音

 # Basic usage with text
edge-tts-cli speak --text " Hello, World! " --output hello.mp3

# Read text from file
edge-tts-cli speak --file input.txt --output hello.mp3

# Specify voice and language
edge-tts-cli speak --text " Hello, World! " --voice en-US-JennyNeural --lang en-US --output hello.mp3

# Adjust speech parameters
edge-tts-cli speak --text " Hello, World! " --rate +50% --pitch +10Hz --volume +20% --output hello.mp3

# Enable JSON and SRT export
edge-tts-cli speak --text " Hello, World! " --save-json --save-srt --output hello.mp3

# Set boundary type
edge-tts-cli speak --text " Hello, World! " --boundary word --output hello.mp3

# Use proxy
edge-tts-cli speak --text " Hello, World! " --proxy http://host:port --output hello.mp3

speak命令的可用选项：

• --text ：讲话
• --file ：输入文本文件路径
• --voice ：使用的声音（默认：En-us-Jennyneural）
• --lang ：要使用的语言（默认：en-us）
• --rate ：语音率（例如 +0％，-10％）
• --pitch ：语音音调（例如 +0Hz，-10Hz）
• --volume ：语音量（例如 +0％，-10％）
• --boundary ：边界类型（句子或单词，默认：句子）
• --save-json ：将计时信息保存为JSON
• --save-srt ：将定时信息保存为SRT
• --proxy ：代理URL（例如http：//主机：端口）
• --output ：输出文件名（默认：output.mp3）

GUI申请使用情况

1. 下载并安装Edge TTS演示的最新版本
2. 打开应用程序并输入要转换的文本
3. 选择所需的语音和参数设置（速率，音高，音量）
4. 如果需要，启用JSON/SRT导出
5. 选择边界类型（句子或单词）
6. 单击“转换和播放”按钮以聆听综合语音
7. 使用导出按钮保存文件：
   • 在iOS上：使用系统共享表进行灵活的文件处理
   • 在MacOS上：使用保存对话框选择保存位置

导出功能

文件类型

• mp3：带有综合语音的音频文件
• JSON：每个句子/单词的定时元数据
• SRT：带时间戳的字幕文件

特定于平台的出口

• iOS/iPados：
  • 系统共享表集成
  • 分享到其他应用程序
  • 空投支撑
  • 保存到文件应用程序
• macos：
  • 本机保存对话框
  • 选择保存位置
  • 文件类型过滤
  • 自动文件扩展名处理

常见的声音

您可以使用以下方式获取支持的声音列表

 let voices = try await tts . fetchVoices ( )

流行的英语声音包括：

• En-Us-Jennyneal（女）
• en-us-guyneal（男性）
• en-gb-sonianeral（女）
• en-gb-ryanneal（男性）
• eN-au-natashaneural（女）

贡献

我们欢迎所有形式的贡献，包括但不限于：

• 错误报告和功能建议
• 代码改进
• 文档改进
• 测试案例添加

执照

此项目已根据MIT许可证获得许可 - 有关详细信息，请参见许可证。TXT文件。