第一篇【传奇开心果系列】Python的pyttsx3库技术点案例示例：文本转换语言_pyttsx3 示例_pyttsx3 不阻塞

Python的pyttsx3库技术点案例示例系列

短博文目录

前言

pyttsx3是一个用于将文本转换为语音的Python库。它提供了一种简单而灵活的方式，让开发者可以通过编程将文本转换为可听的语音输出。
通过简单的步骤，开发者可以使用pyttsx3快速实现将文本转换为语音的功能，并在各种应用场景中应用，例如语音反馈、语音交互界面、语音辅助阅读等。

一、pyttsx3主要特点和功能介绍

1. 多平台支持：pyttsx3可以在多个操作系统上运行，包括Windows、Mac和Linux等。
2. 多语言支持：它支持多种语言，包括英语、中文、法语、德语、西班牙语等，可以根据需要选择合适的语言进行语音合成。
3. 自定义语音引擎：pyttsx3允许用户选择不同的语音引擎，如SAPI5、nsss、espeak等，以适应不同的需求和平台。
4. 调整语速和音量：开发者可以通过设置参数来控制生成语音的速度和音量，以满足个性化的需求。
5. 异步支持：pyttsx3支持异步操作，可以在后台生成语音，而不会阻塞主线程的执行。
6. 事件回调：它提供了事件回调机制，可以监听语音合成的进度和状态，以便在需要时执行相应的操作。

二、pyttsx3文字转语音操作步骤介绍

使用pyttsx3进行文字转语音通常包括以下步骤：

1. 安装pyttsx3库：可以使用pip命令来安装pyttsx3库，例如pip install pyttsx3。
2. 创建语音引擎：使用pyttsx3库创建一个语音引擎对象。
3. 设置语言和声音：根据需要设置语言和声音引擎。
4. 调整参数：可选地调整语速和音量等参数。
5. 将文本转换为语音：使用语音引擎的say()方法将文本转换为语音。
6. 播放语音：使用语音引擎的runAndWait()方法播放生成的语音。

三、多平台支持介绍和示例代码

当使用pyttsx3进行文字转语音时，可以在不同操作系统上运行。以下是一个示例代码，展示了在Windows、Mac和Linux上使用pyttsx3的基本用法：

import pyttsx3

# 创建语音引擎对象
engine = pyttsx3.init()

# 设置语言和声音
# Windows上的示例
# engine.setProperty('voice', 'com.microsoft.speech.platform.voice.SynthesizerVoice')
# Mac上的示例
# engine.setProperty('voice', 'com.apple.speech.synthesis.voice.Alex')
# Linux上的示例
# engine.setProperty('voice', 'voice\_name')

# 调整参数（可选）
# engine.setProperty('rate', 150) # 设置语速，值越大语速越快
# engine.setProperty('volume', 0.8) # 设置音量，范围从0.0到1.0

# 将文本转换为语音
text = "Hello, World!"
engine.say(text)

# 播放语音
engine.runAndWait()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

在上述示例代码中，首先我们导入了pyttsx3库。然后，通过pyttsx3.init()方法创建了一个语音引擎对象engine。

接下来，根据需要设置语言和声音。在Windows上，可以使用engine.setProperty('voice', 'com.microsoft.speech.platform.voice.SynthesizerVoice')来设置语音引擎。在Mac上，可以使用engine.setProperty('voice', 'com.apple.speech.synthesis.voice.Alex')来设置语音引擎。在Linux上，可以根据系统中可用的语音引擎设置相应的值，例如engine.setProperty('voice', 'voice_name')。

如果需要，可以使用engine.setProperty('rate', 150)来调整语速，值越大语速越快。使用engine.setProperty('volume', 0.8)来调整音量，范围从0.0到1.0。

然后，我们将要转换为语音的文本赋值给变量text，并使用engine.say(text)将文本转换为语音。

最后，通过调用engine.runAndWait()方法播放生成的语音。

请注意，示例代码中的语音引擎设置部分需要根据具体操作系统和语音引擎进行相应的调整。你可以根据自己的需求和操作系统来设置合适的语音引擎。

四、多语言支持介绍和示例代码

当使用pyttsx3进行多语言文字转语音时，可以根据需要选择合适的语言进行语音合成。以下是一个示例代码，展示了如何设置不同语言的语音合成：

import pyttsx3

# 创建语音引擎对象
engine = pyttsx3.init()

# 设置语言和声音
# 英语
engine.setProperty('voice', 'en')
# 中文
# engine.setProperty('voice', 'zh')
# 法语
# engine.setProperty('voice', 'fr')
# 德语
# engine.setProperty('voice', 'de')
# 西班牙语
# engine.setProperty('voice', 'es')

# 将文本转换为语音
text = "Hello, World!"
engine.say(text)

# 播放语音
engine.runAndWait()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

在上述示例代码中，我们首先导入了pyttsx3库。然后，通过pyttsx3.init()方法创建了一个语音引擎对象engine。

接下来，根据需要设置语言和声音。在示例代码中，我们展示了几种常见语言的设置示例。

• 英语：使用engine.setProperty('voice', 'en')来设置英语语音引擎。
• 中文：使用engine.setProperty('voice', 'zh')来设置中文语音引擎。
• 法语：使用engine.setProperty('voice', 'fr')来设置法语语音引擎。
• 德语：使用engine.setProperty('voice', 'de')来设置德语语音引擎。
• 西班牙语：使用engine.setProperty('voice', 'es')来设置西班牙语语音引擎。

你可以根据需要选择合适的语言和语音引擎。

然后，我们将要转换为语音的文本赋值给变量text，并使用engine.say(text)将文本转换为语音。

最后，通过调用engine.runAndWait()方法播放生成的语音。

请注意，示例代码中的语音引擎设置部分需要根据具体的语言和操作系统进行相应的调整。你可以根据自己的需求和操作系统来设置合适的语音引擎和语言。

五、自定义语言引擎介绍和示例代码

pyttsx3允许用户选择不同的语音引擎来适应不同的需求和平台。以下是一个示例代码，展示了如何选择不同的语音引擎：

import pyttsx3

# 创建语音引擎对象
engine = pyttsx3.init()

# 设置语音引擎
# Windows上的示例，使用SAPI5引擎
# engine.setProperty('engine', 'sapi5')
# Mac上的示例，使用nsss引擎
# engine.setProperty('engine', 'nsss')
# Linux上的示例，使用espeak引擎
# engine.setProperty('engine', 'espeak')

# 将文本转换为语音
text = "Hello, World!"
engine.say(text)

# 播放语音
engine.runAndWait()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

在上述示例代码中，我们首先导入了pyttsx3库。然后，通过pyttsx3.init()方法创建了一个语音引擎对象engine。

接下来，根据需要设置语音引擎。在示例代码中，我们展示了在不同平台上选择不同语音引擎的示例。

• 在Windows上，可以使用SAPI5引擎，使用engine.setProperty('engine', 'sapi5')来设置语音引擎。
• 在Mac上，可以使用nsss引擎，使用engine.setProperty('engine', 'nsss')来设置语音引擎。
• 在Linux上，可以使用espeak引擎，使用engine.setProperty('engine', 'espeak')来设置语音引擎。

你可以根据自己的需求和平台选择合适的语音引擎。

然后，我们将要转换为语音的文本赋值给变量text，并使用engine.say(text)将文本转换为语音。

最后，通过调用engine.runAndWait()方法播放生成的语音。

请注意，示例代码中的语音引擎设置部分需要根据具体的平台和语音引擎进行相应的调整。你可以根据自己的需求和平台来设置合适的语音引擎。

六、调整语速和音量介绍和示例代码

是的，使用pyttsx3，开发者可以通过设置参数来调整生成语音的速度和音量。以下是一个示例代码，展示了如何调整语速和音量：

import pyttsx3

# 创建语音引擎对象
engine = pyttsx3.init()

# 获取当前语音引擎的属性
rate = engine.getProperty('rate')  # 获取当前语速
volume = engine.getProperty('volume')  # 获取当前音量

# 设置新的语速和音量
new_rate = 150  # 新的语速（默认为100，可以调整为更高或更低的值）
new_volume = 0.8  # 新的音量（默认为1，可以调整为0到1之间的值）

# 设置语速和音量
engine.setProperty('rate', new_rate)
engine.setProperty('volume', new_volume)

# 将文本转换为语音
text = "Hello, World!"
engine.say(text)

# 播放语音
engine.runAndWait()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

在上述示例代码中，我们首先导入了pyttsx3库。然后，通过pyttsx3.init()方法创建了一个语音引擎对象engine。

接下来，我们使用engine.getProperty()方法获取当前语音引擎的属性，包括语速和音量。getProperty('rate')获取当前语速，getProperty('volume')获取当前音量。

然后，我们可以根据需要设置新的语速和音量。在示例代码中，我们将语速设置为150（默认为100），将音量设置为0.8（默认为1）。

通过engine.setProperty()方法，我们将新的语速和音量设置到语音引擎对象中，使用setProperty('rate', new_rate)设置新的语速，使用setProperty('volume', new_volume)设置新的音量。

接下来，我们将要转换为语音的文本赋值给变量text，并使用engine.say(text)将文本转换为语音。

最后，通过调用engine.runAndWait()方法播放生成的语音。

你可以根据需要调整语速和音量的值，以满足个性化的需求。

七、异步支持介绍和示例代码

目前的pyttsx3库并不直接支持异步操作。pyttsx3库是一个同步库，它会在语音生成完成之前阻塞主线程的执行。

如果你需要在后台生成语音而不阻塞主线程，你可以考虑使用多线程或异步任务来实现。你可以将语音生成的任务放在一个单独的线程或异步任务中执行，以便在后台进行处理，同时不影响主线程的执行。

以下是一个示例代码，展示了如何使用多线程来在后台生成语音：

import pyttsx3
import threading

def generate\_speech(text):
    # 创建语音引擎对象
    engine = pyttsx3.init()

    # 将文本转换为语音
    engine.say(text)

    # 播放语音
    engine.runAndWait()

# 在主线程中执行其他任务

# 创建一个新的线程来生成语音
text = "Hello, World!"
thread = threading.Thread(target=generate_speech, args=(text,))
thread.start()

# 主线程继续执行其他任务

# 等待语音生成线程完成
thread.join()

# 主线程继续执行其他任务

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

在上述示例代码中，我们首先导入了pyttsx3库和threading模块。然后，我们定义了一个generate_speech函数，用于在新的线程中生成语音。

在generate_speech函数中，我们创建了一个新的语音引擎对象engine，将文本转换为语音，并播放语音。

在主线程中，我们可以执行其他任务。然后，我们创建一个新的线程，将generate_speech函数作为目标函数，传入要转换为语音的文本作为参数。通过thread.start()方法启动线程。

主线程可以继续执行其他任务，而语音生成的任务会在新的线程中后台执行。如果需要等待语音生成线程完成，可以使用thread.join()方法进行等待。

请注意，使用多线程需要注意线程安全和资源管理等问题。确保在使用多线程时正确处理共享资源和线程同步。

另外，如果你更倾向于使用异步操作，你可以考虑使用其他异步库或框架来实现类似的功能，例如使用asyncio库或基于异步的语音合成服务。这些库和服务可以提供异步生成语音的功能，并与其他异步代码一起工作。

八、事件回调介绍和示例代码

目前的pyttsx3库并不直接提供事件回调机制来监听语音合成的进度和状态。pyttsx3库是一个相对简单的文本到语音转换库，它没有内置的事件回调功能。

如果你需要监听语音合成的进度和状态，你可以考虑使用其他更专业的语音合成库或服务，这些库或服务通常提供更丰富的功能和事件回调机制。

一个常见的选择是使用Google Text-to-Speech (gTTS) API，它是一个功能强大的语音合成服务，支持多种语言和声音选项。你可以使用它的Python库来生成语音，并利用其事件回调机制来监听合成进度和状态。

以下是一个使用gTTS库的示例代码，展示了如何使用事件回调来监听语音合成的进度和状态：

from gtts import gTTS
import time

def on\_progress(current, total):
    print(f"合成进度: {current}/{total}")

def on\_complete():
    print("语音合成完成")

# 要转换为语音的文本
text = "Hello, World!"

# 创建gTTS对象，设置文本和语言
tts = gTTS(text, lang='en')

# 设置事件回调
tts.on_progress(on_progress)
tts.on_complete(on_complete)

# 保存语音到文件
tts.save('output.mp3')

# 等待合成完成
while not tts.done:
    time.sleep(0.1)

# 打印合成的总时长
print(f"合成时长: {tts.total\_duration} 秒")

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

在上述示例代码中，我们首先导入了gTTS库和time模块。然后，我们定义了两个回调函数：on_progress和on_complete。

on_progress函数在语音合成过程中被调用，它接收两个参数：当前合成的片段数和总片段数。在这个示例中，我们简单地打印当前合成的进度。

on_complete函数在语音合成完成后被调用，它不接收任何参数。在这个示例中，我们简单地打印一条消息表示合成完成。

接下来，我们创建了一个gTTS对象，并设置要转换为语音的文本和语言。

然后，我们使用tts.on_progress方法将on_progress函数设置为合成进度的事件回调，使用tts.on_complete方法将on_complete函数设置为合成完成的事件回调。

接下来，我们通过调用tts.save方法将合成的语音保存到文件。

最后，我们使用一个循环等待语音合成完成，直到tts.done属性为True。在等待期间，我们使用time.sleep方法暂停一小段时间。

请注意，以上示例代码使用的是gTTS库，而不是pyttsx3库。这是因为pyttsx3库并不直接提供事件回调机制。如果你需要事件回调功能，你可能需要使用其他库或服务来实现。

九、使用pyttsx3进行文字转语音通常步骤示例代码

当使用pyttsx3库进行文字转语音时，通常的步骤如下：

1. 安装pyttsx3库：

pip install pyttsx3

1
2

2. 导入pyttsx3库：

import pyttsx3

1
2

3. 创建一个pyttsx3的引擎对象：

engine = pyttsx3.init()

1
2

4. 设置引擎的属性（可选）：

# 设置语速（默认为中等速度）
engine.setProperty('rate', 150)

# 设置音量（0.0到1.0之间，默认为1.0）
engine.setProperty('volume', 0.8)

# 设置语音声音（默认为系统默认声音）
voices = engine.getProperty('voices')
engine.setProperty('voice', voices[0].id)  # 选择第一个声音

1
2
3
4
5
6
7
8
9
10

5. 使用引擎进行文字转语音：

做了那么多年开发，自学了很多门编程语言，我很明白学习资源对于学一门新语言的重要性，这些年也收藏了不少的Python干货，对我来说这些东西确实已经用不到了，但对于准备自学Python的人来说，或许它就是一个宝藏，可以给你省去很多的时间和精力。

别在网上瞎学了，我最近也做了一些资源的更新，只要你是我的粉丝，这期福利你都可拿走。

我先来介绍一下这些东西怎么用，文末抱走。

---

（1）Python所有方向的学习路线（新版）

这是我花了几天的时间去把Python所有方向的技术点做的整理，形成各个领域的知识点汇总，它的用处就在于，你可以按照上面的知识点去找对应的学习资源，保证自己学得较为全面。

最近我才对这些路线做了一下新的更新，知识体系更全面了。

（2）Python学习视频

包含了Python入门、爬虫、数据分析和web开发的学习视频，总共100多个，虽然没有那么全面，但是对于入门来说是没问题的，学完这些之后，你可以按照我上面的学习路线去网上找其他的知识资源进行进阶。

（3）100多个练手项目

我们在看视频学习的时候，不能光动眼动脑不动手，比较科学的学习方法是在理解之后运用它们，这时候练手项目就很适合了，只是里面的项目比较多，水平也是参差不齐，大家可以挑自己能做的项目去练练。

（4）200多本电子书

这些年我也收藏了很多电子书，大概200多本，有时候带实体书不方便的话，我就会去打开电子书看看，书籍可不一定比视频教程差，尤其是权威的技术书籍。

基本上主流的和经典的都有，这里我就不放图了，版权问题，个人看看是没有问题的。

（5）Python知识点汇总

知识点汇总有点像学习路线，但与学习路线不同的点就在于，知识点汇总更为细致，里面包含了对具体知识点的简单说明，而我们的学习路线则更为抽象和简单，只是为了方便大家只是某个领域你应该学习哪些技术栈。

（6）其他资料

还有其他的一些东西，比如说我自己出的Python入门图文类教程，没有电脑的时候用手机也可以学习知识，学会了理论之后再去敲代码实践验证，还有Python中文版的库资料、MySQL和HTML标签大全等等，这些都是可以送给粉丝们的东西。

这些都不是什么非常值钱的东西，但对于没有资源或者资源不是很好的学习者来说确实很不错，你要是用得到的话都可以直接抱走，关注过我的人都知道，这些都是可以拿到的。

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里无偿获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！