使用pyttsx3实现简单tts服务

操作系统：Windows 10_x64 python版本：Python 3.9.2_x64 pyttsx3版本： 2.90   pyttsx3是一个tts引擎包装器，可对接SAPI5、NSSS（NSSpeechSynthesizer）、espeak等引擎，实现统一的tts接口。

 pyttsx3的地址：https://pypi.org/project/pyttsx3/

 帮助文档地址：https://pyttsx3.readthedocs.org/

安装pyttsx3依赖包：

pip install pyttsx3

接口介绍

1、init接口

使用的具体引擎可以在init里面指定：

pyttsx3.init([driverName : string, debug : bool]) → pyttsx3.Engine   入参： driverName ： 可选，用于指定tts引擎，若未指定，则使用系统默认引擎。

• sapi5 - windows环境
• nsss - Mac OS X环境
• espeak - 非windows和Mac OS X 的其它系统

debug ： 可选，用于指定是否开启调试功能，若未指定，则不开启。

 

 2、engine接口

使用init接口初始完毕，会返回engine对象。 engine对象的方法如下：

• connect

注册回调函数用于订阅事件。 入参及出参 connect(topic : string, cb : callable) → dict topic ：订阅事件的名称，有效的名称 cb ： 回调函数 返回token信息，可用于后续取消订阅。   可用事件如下： started-utterance 引擎开始说话时触发，回调函数定义如下： onStartUtterance(name : string) -> None started-word 引擎说词语时触发，回调函数定义如下： onStartWord(name : string, location : integer, length : integer) -> None finished-utterance 引擎说话结束时触发，回调函数定义如下： onFinishUtterance(name : string, completed : bool) -> None error 引擎遇到错误时触发，回调函数定义如下： onError(name : string, exception : Exception) -> None 

• disconnect

反注册回调函数。 disconnect(token : dict) token是connect函数返回的数据。 

• endLoop

结束正在运行的事件循环。 

• getProperty

获取tts的属性，比如语速、嗓音、音量等。 getProperty(name : string) -> object 参数： name - 属性名称 object - 属性对象 属性列表： rate - 语速 voice - 嗓音 voices - 嗓音集，列出 pyttsx3.voice.Voice 里面定义的所有嗓音 volume - 音量 

• isBusy

判断当前引擎是否在执行文本转语音。 isBusy() -> bool 返回值： True - 正在执行文本转语音 False - 未执行

• iterate

当使用外部事件循环时，该方法需要被调用。  

• runAndWait

runAndWait() -> None 执行缓存的命令并等待完成。

• save_to_file

执行语音转文本操作，并生成音频文件。 save_to_file(text : unicode, filename : string, name : string) 参数： text - 要执行转语音的文本 filename - 文件名称 name - 可选，注册需要通知的关键字 示例： engine.save_to_file('Hello World' , 'test.mp3')  

• say

执行语音转文本操作，并播放文本内容。 say(text : unicode, name : string) -> None 参数： text - 要执行转语音的文本 name - 可选，注册需要通知的关键字 示例： engine.say('I will speak this text!', 'speak')  

• setProperty

设置tts的属性，比如语速、嗓音、音量等。 setProperty(name, value) -> None 参数： name - 属性名称 value - 属性值 属性列表： rate - 语速，设置每分钟说几个字 voice - 嗓音，可以设置不同嗓音的说话人 volume - 音量，介于0到1的小数  

• startLoop

开始事件循环。 startLoop([useDriverLoop : bool]) -> None  

• stop

停止当前正在运行的文本转语音并清理命令队列。  使用示例  1、使用pyttsx3播放语音及生成文件 简单示例：

#! /usr/bin/env python3
#-*- coding:utf-8 -*-

# pip install pyttsx3

import pyttsx3

def onStart(name):
   print('starting',name)

def onWord(name,location,length):
   print('word',name,location,length)

def onEnd(name,completed):
   print('finishing',name,completed)

engine = pyttsx3.init()

# 注册回调函数
engine.connect('started-utterance', onStart)
engine.connect('started-word', onWord)
engine.connect('finished-utterance', onEnd)

# 语音转文本测试（直接播放）
engine.say("I will speak this text")
engine.say('I will speak this text!', 'speak') # 注册 speak 关键字，进行事件通知
engine.say("我可以说话了")

# 语音转文本测试（文件存储到磁盘） 
engine.save_to_file('我可以说话了', 'test.mp3')

# 运行并等待
engine.runAndWait()

运行效果如下：

 

2、使用pyttsx3搭建简单的tts服务

这里使用tornado搭建简单的http服务（tornado是一个开源的网络服务器框架），来实现tts服务。 时序如下：

 主逻辑代码如下：

def text2File(text,dstFile):
    engine = pyttsx3.init()
    engine.save_to_file(text,dstFile)
    engine.runAndWait()

class MainHandler(tornado.web.RequestHandler):
    def get(self):
        tmpFile = "1.mp3" 
        print("get",self.request.arguments)
        text = self.get_query_argument("text").strip()
        print("text : %s" % text)
        if len(text) > 0 :
            text2File(text,tmpFile)
            self.set_header('content-type', 'audio/mpeg')
            fbin = open(tmpFile,"rb").read()
            self.set_header('Content-Length', len(fbin))
            self.set_header('Content-Disposition', 'attachment;filename="%s"'%tmpFile)
            self.write(fbin)
            self.finish()            
        else:
            self.set_header('content-type', 'application/json')
            self.finish(json.dumps({"result" : "input text "}))
        
    def post(self):
        print("post")
        print(self.request.arguments)

运行效果如下：

 

 本文涉及资源下载地址：https://pan.baidu.com/s/1Dc8zlL2fs8p4ebF916WyXQ

 

 可关注微信公众号（聊聊博文）后回复 2022040401 获得提取码。

微信公众号：

E-Mail : Mike_Zhang@live.com

转载请注明出处，谢谢！