Python 使用总结之：Python 文本转语音引擎 - pyttsx3 完全指南

文本转语音（TTS，Text-to-Speech）技术已经广泛应用于语音助手、智能硬件、教育软件等多个领域。Python 提供了多个库来实现 TTS，其中 pyttsx3 是一个非常常用的跨平台 TTS 引擎。本文将详细介绍如何使用 pyttsx3 实现文本转语音的功能。

---

一、安装 pyttsx3 库

首先，你需要安装 pyttsx3 库。你可以通过以下命令来安装：

pip install pyttsx3

pyttsx3 是一个离线库，支持 Windows、Mac 和 Linux 系统。它并不依赖于互联网，因此即使没有网络也可以正常工作。

---

二、使用 pyttsx3 实现文本转语音

1. 基本用法

使用 pyttsx3 最基本的功能就是将输入的文本转换成语音并播放。下面是一个简单的示例代码：

import pyttsx3# 初始化 pyttsx3 引擎
engine = pyttsx3.init()# 设置要转语音的文本
text = "Hello, welcome to the world of text-to-speech in Python!"# 将文本转换为语音并播放
engine.say(text)# 等待语音播放完成
engine.runAndWait()

• engine.say(text)：将文本传递给语音引擎进行处理。

• engine.runAndWait()：让引擎开始播放语音并等待其完成。

2. 设置语音属性

pyttsx3 允许你设置语音的不同属性，例如语速、音量和语音类型（男性或女性语音）。下面是一个示例，展示了如何调整这些设置：

import pyttsx3# 初始化引擎
engine = pyttsx3.init()# 设置语音属性
engine.setProperty('rate', 150)  # 设置语速，默认值约为 200
engine.setProperty('volume', 0.9)  # 设置音量，范围是 0.0 到 1.0# 获取可用的语音列表
voices = engine.getProperty('voices')# 设置语音（选择男性或女性语音）
engine.setProperty('voice', voices[1].id)  # voices[0]是男性，voices[1]是女性# 播放文本
text = "This is a customized speech. I hope you like it!"
engine.say(text)# 等待播放完成
engine.runAndWait()

• engine.setProperty('rate', 150)：设置语速。默认语速大约是 200，可以通过设置较小的数字来减慢语速。

• engine.setProperty('volume', 0.9)：设置音量，音量范围为 0.0 到 1.0。

• engine.getProperty('voices')：获取系统中安装的所有语音（男性和女性），你可以选择自己喜欢的语音。

3. 获取并选择语音

pyttsx3 提供了多种语音，通常包括男性和女性语音，具体内容依赖于操作系统的支持。你可以通过以下方法列出系统支持的语音，并选择其中一个：

import pyttsx3# 初始化引擎
engine = pyttsx3.init()# 获取系统中的所有语音
voices = engine.getProperty('voices')# 显示可用的语音
for voice in voices:print(f"Voice: {voice.id} - {voice.name}")# 设置使用的语音
engine.setProperty('voice', voices[1].id)  # 选择女性语音# 播放文本
text = "This is a test with selected voice."
engine.say(text)
engine.runAndWait()

你可以遍历 voices 列表，查看系统支持的语音类型。然后使用 engine.setProperty('voice', voice.id) 来选择某个特定语音。

4. 错误处理和调试

在使用 pyttsx3 时，有时可能会遇到一些错误。为此，你可以使用异常处理来确保程序的健壮性：

import pyttsx3try:# 初始化引擎engine = pyttsx3.init()# 设置语音属性engine.setProperty('rate', 150)engine.setProperty('volume', 0.9)# 获取系统支持的语音voices = engine.getProperty('voices')engine.setProperty('voice', voices[0].id)  # 使用男性语音# 播放文本engine.say("This is a test message.")engine.runAndWait()except Exception as e:print(f"Error: {e}")

这可以帮助你捕获并处理任何在语音播放过程中发生的错误。

---

三、语音文件保存

除了直接播放语音，pyttsx3 还允许你将文本转换为语音并保存为 .mp3 或 .wav 文件。要实现这一点，通常需要借助其他库（如 pydub）来完成音频格式转换，因为 pyttsx3 默认不直接支持保存为音频文件。但可以通过以下方式将音频保存到文件：

import pyttsx3
import wave
import pyaudio# 初始化引擎
engine = pyttsx3.init()# 创建一个音频流
output_file = "output_audio.wav"
engine.save_to_file('Hello, this is a saved audio file.', output_file)# 播放保存的音频文件
engine.runAndWait()print(f"Audio saved as {output_file}")

这里，save_to_file() 方法可以将文本保存为 .wav 文件。你可以通过这种方式将文本转换为语音并保存。

---

四、更多进阶用法

1. 调整音质

如果你需要更高质量的语音，可以选择使用不同的语音引擎。pyttsx3 默认使用系统提供的语音引擎（如 SAPI5，NSSpeechSynthesizer），但也可以根据需要切换引擎。

2. 支持多语言

虽然 pyttsx3 默认支持英语，但在多语言应用中，你可以选择不同的语言支持，前提是你的操作系统或语音库提供了这些语言的支持。对于中文或其他语言，你可以通过调整语音引擎设置来支持其他语言。

3. 语音合成效果

pyttsx3 提供的基本语音合成效果可能较为简单，如果你需要更高质量的语音效果，可以考虑使用一些第三方 API，如 Google TTS、Amazon Polly 或 Microsoft Azure Speech 等。

---

五、常见问题与解决方案

1. pyttsx3 初始化失败

• 问题：pyttsx3.init() 调用失败，无法初始化引擎。

• 解决方案：尝试安装或更新必要的语音驱动程序，或者重新安装 pyttsx3：

pip uninstall pyttsx3
pip install pyttsx3

2. 语音播放不清晰或不自然

• 问题：生成的语音质量较差，或者语音不清晰。

• 解决方案：调整语速（rate）和音量（volume）属性，或者尝试使用不同的语音（voice）。

3. 无法保存为音频文件

• 问题：save_to_file 方法未能正常工作，无法保存音频文件。

• 解决方案：确保文件路径有效，且当前目录可写。如果是跨平台使用，确保你安装了音频库，如 pyaudio 或 wave。

---

总结

pyttsx3 是一个强大且简单的 Python 库，用于实现文本转语音功能。通过 pyttsx3，你可以轻松地将文本内容转换为语音，支持设置语速、音量、语音类型等多种属性。该库不依赖网络，适合离线使用，适合多种应用场景，如语音助手、智能硬件、教育软件等。

对于更高质量的语音合成，可以结合其他库或服务，如 Google TTS、Amazon Polly 或 Microsoft Azure Speech API。

Python 使用总结之：Python 文本转语音引擎 – pyttsx3 完全指南 – 菜鸟-创作你的创作