如何快速使用Edge TTS：无浏览器环境下的Python文本转语音解决方案
项目地址: https://gitcode.com/GitHub_Trending/ed/edge-tts Edge TTS是一个强大的Python模块，它允许您在不需要Microsoft Edge浏览器、Windows系统或API密钥的情况下，直接从Python代码中使用Microsoft Edge的在线文本转语音服务。无论是开发语音应用还是添加语音功能到现有项目，Edge TTS都能提供简单高效的解决方案。
简单三步安装Edge TTS模块
Edge TTS的安装过程非常简单，您可以通过pip或pipx两种方式进行安装。对于普通用户，推荐使用pip安装：
pip install edge-tts
如果您只需要使用edge-tts和edge-playback命令行工具，使用pipx安装会更加隔离和干净：
pipx install edge-tts
安装完成后，您就可以在命令行或Python代码中使用Edge TTS的全部功能了。
快速上手：使用命令行生成语音文件
Edge TTS提供了直观的命令行工具，让您无需编写代码即可快速生成语音文件。最基本的用法如下：
edge-tts --text "Hello, world!" --write-media hello.mp3 --write-subtitles hello.srt
这条命令会将文本"Hello, world!"转换为MP3音频文件hello.mp3，同时生成对应的SRT字幕文件hello.srt。
探索丰富的语音选项
Edge TTS支持多种语音和语言。您可以通过以下命令列出所有可用的语音：
edge-tts --list-voices
找到合适的语音后，您可以在命令中指定使用该语音，例如使用阿拉伯语语音：
edge-tts --voice ar-EG-SalmaNeural --text "مرحبا كيف حالك؟" --write-media hello_in_arabic.mp3 --write-subtitles hello_in_arabic.srt
调整语音参数
Edge TTS还允许您调整语音的速率、音量和音调，以获得更符合需求的语音效果：
# 降低语速
edge-tts --rate=-50% --text "Hello, world!" --write-media hello_with_rate_lowered.mp3
# 降低音量
edge-tts --volume=-50% --text "Hello, world!" --write-media hello_with_volume_lowered.mp3
# 降低音调
edge-tts --pitch=-50Hz --text "Hello, world!" --write-media hello_with_pitch_lowered.mp3
在Python代码中使用Edge TTS
除了命令行工具，Edge TTS还可以直接在Python代码中使用。项目提供了多个示例，展示了如何在Python中使用Edge TTS的同步和异步接口。
异步生成音频示例
以下是一个使用预定义语音生成音频的异步示例：
import asyncio
from edge_tts import Communicate
async def amain() -> None:
communicate = Communicate("Hello, world!", "en-US-GuyNeural")
await communicate.save("hello.mp3")
if __name__ == "__main__":
asyncio.run(amain())
您可以在examples/async_audio_gen_with_predefined_voice.py中找到完整的代码。
同步流式语音示例
如果您需要同步处理语音流，可以使用stream_sync()方法：
from edge_tts import Communicate
def main() -> None:
communicate = Communicate("Hello, world!", "en-US-GuyNeural")
with open("hello.mp3", "wb") as file:
for chunk in communicate.stream_sync():
if chunk["type"] == "audio":
file.write(chunk["data"])
if __name__ == "__main__":
main()
完整的示例可以在examples/sync_audio_streaming_with_predefined_voice_subtitles.py中找到。
Edge TTS的核心功能模块
Edge TTS的核心功能由多个模块组成，这些模块协同工作以提供高质量的文本转语音服务：
- communicate.py：提供了与Edge TTS服务通信的核心功能，包括异步和同步的流处理。
- voices.py：负责获取和管理可用的语音列表。
- submaker.py：用于生成字幕文件。
- util.py：包含各种辅助函数和命令行工具的实现。
这些模块的源代码可以在src/edge_tts/目录下找到，您可以根据需要进行深入研究或自定义。
使用Edge Playback播放语音
Edge TTS还提供了edge-playback命令，用于直接播放生成的语音：
edge-playback --text "Hello, world!"
除了--write-media、--write-subtitles和--list-voices选项外，所有edge-tts命令都可以与edge-playback一起使用。
总结
Edge TTS是一个功能强大且易于使用的Python模块，它为开发者提供了在无浏览器环境下使用Microsoft Edge文本转语音服务的能力。无论是通过简单的命令行工具还是直接在Python代码中集成，Edge TTS都能满足您的语音生成需求。
通过本文介绍的安装步骤、基本用法和高级功能，您已经掌握了Edge TTS的核心使用方法。现在，您可以开始在自己的项目中集成Edge TTS，为您的应用添加丰富的语音功能了！
如果您想深入了解Edge TTS的更多功能和实现细节，可以查看项目的源代码和示例文件，这些资源将帮助您更好地利用这个强大的文本转语音工具。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
