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文件。