Python文本轉(zhuǎn)語音引擎pyttsx3的使用完全指南

更新時間：2025年04月02日 15:41:25 作者：阿福不是狗

在開發(fā)需要語音輸出功能的應(yīng)用時,文本轉(zhuǎn)語音技術(shù)是一個非常有用的工具,Python的pyttsx3庫提供了一個簡單且離線的方式來實現(xiàn)這一功能,下面小編就來和大家介紹一下pyttsx3的具體使用吧

在開發(fā)需要語音輸出功能的應(yīng)用時，文本轉(zhuǎn)語音(TTS)技術(shù)是一個非常有用的工具。Python的pyttsx3庫提供了一個簡單且離線的方式來實現(xiàn)這一功能，無需依賴互聯(lián)網(wǎng)連接或外部API。本文將詳細(xì)介紹pyttsx3的安裝、基礎(chǔ)使用以及高級功能，幫助你快速掌握這一實用工具。

什么是pyttsx3

pyttsx3是一個跨平臺的Python文本轉(zhuǎn)語音轉(zhuǎn)換庫，它可以在不需要網(wǎng)絡(luò)連接的情況下工作。該庫使用你系統(tǒng)上已安裝的TTS引擎，如Windows上的SAPI5、macOS上的NSS和Linux上的espeak。

安裝

安裝pyttsx3非常簡單，只需使用pip命令：

pip install pyttsx3

在某些系統(tǒng)上，可能還需要安裝額外的依賴：

Windows：通常不需要額外安裝（使用SAPI5）

macOS：可能需要安裝PyObjC

pip install pyobjc

Linux：需要安裝espeak

sudo apt-get install espeak

基本使用

初始化引擎并說話

以下是使用pyttsx3的最簡單示例：

import pyttsx3

# 初始化TTS引擎
engine = pyttsx3.init()

# 設(shè)置要說的文本
engine.say("你好，我是Python文本轉(zhuǎn)語音引擎")

# 運行并等待語音完成
engine.runAndWait()

調(diào)整語音屬性

1. 改變語速

語速以每分鐘字?jǐn)?shù)(WPM)衡量，默認(rèn)值通常為200：

# 獲取當(dāng)前語速
rate = engine.getProperty('rate')
print(f"當(dāng)前語速：{rate}")

# 設(shè)置新的語速 (降低50%)
engine.setProperty('rate', rate-100)

engine.say("這是降低語速后的語音效果")
engine.runAndWait()

2. 改變音量

音量范圍從0.0到1.0：

# 獲取當(dāng)前音量
volume = engine.getProperty('volume')
print(f"當(dāng)前音量：{volume}")

# 設(shè)置新的音量 (0.0 到 1.0)
engine.setProperty('volume', 0.7)  # 70%音量

engine.say("這是調(diào)整音量后的語音效果")
engine.runAndWait()

3. 更改聲音

pyttsx3允許使用系統(tǒng)上可用的不同聲音：

# 獲取可用聲音的列表
voices = engine.getProperty('voices')

# 打印可用聲音的信息
for i, voice in enumerate(voices):
    print(f"語音{i}:")
    print(f" - ID: {voice.id}")
    print(f" - 名稱: {voice.name}")
    print(f" - 語言: {voice.languages}")
    print(f" - 性別: {voice.gender}")
    print(f" - 年齡: {voice.age}")

# 設(shè)置第二個聲音（如果有的話）
if len(voices) > 1:
    engine.setProperty('voice', voices[1].id)
    engine.say("這是使用另一個聲音的效果")
    engine.runAndWait()

高級功能

將語音保存為文件

除了直接播放語音外，pyttsx3還可以將語音保存為音頻文件：

engine = pyttsx3.init()

# 設(shè)置要保存的文本
text = "這段文本將被保存為音頻文件"

# 保存為WAV文件
engine.save_to_file(text, 'output.wav')
engine.runAndWait()

使用事件回調(diào)

pyttsx3提供了事件回調(diào)機制，可以在語音開始、結(jié)束或發(fā)生錯誤時執(zhí)行特定操作：

def onStart(name):
    print(f'開始: {name}')

def onWord(name, location, length):
    print(f'詞: {name}, 位置: {location}, 長度: {length}')

def onEnd(name, completed):
    print(f'結(jié)束: {name}, 完成: {completed}')

# 連接回調(diào)函數(shù)
engine = pyttsx3.init()
engine.connect('started-utterance', onStart)
engine.connect('started-word', onWord)
engine.connect('finished-utterance', onEnd)

engine.say('這段文本將觸發(fā)回調(diào)函數(shù)')
engine.runAndWait()

多線程使用

在圖形界面或需要非阻塞語音輸出的應(yīng)用中，可以在單獨的線程中運行TTS引擎：

import threading
import time

def speak_in_thread(text):
    engine = pyttsx3.init()
    engine.say(text)
    engine.runAndWait()
    engine.stop()

# 創(chuàng)建一個線程來播放語音
speech_thread = threading.Thread(target=speak_in_thread, args=("這段文本將在單獨的線程中播放，不會阻塞主程序",))
speech_thread.start()

# 主程序可以繼續(xù)執(zhí)行其他任務(wù)
print("語音播放已開始，但主程序繼續(xù)執(zhí)行")
for i in range(5):
    print(f"主線程計數(shù): {i}")
    time.sleep(0.5)

# 等待語音線程結(jié)束
speech_thread.join()
print("語音播放完成")

實用示例

簡單的文本閱讀器

import pyttsx3

def text_reader(file_path):
    try:
        with open(file_path, 'r', encoding='utf-8') as file:
            text = file.read()
            
        engine = pyttsx3.init()
        print("開始閱讀文件...")
        engine.say(text)
        engine.runAndWait()
        print("文件閱讀完成")
    except FileNotFoundError:
        print(f"錯誤: 找不到文件 '{file_path}'")
    except Exception as e:
        print(f"發(fā)生錯誤: {e}")

# 使用示例
text_reader('example.txt')

簡單的語音提醒工具

import pyttsx3
import time
import threading

class VoiceReminder:
    def __init__(self):
        self.engine = pyttsx3.init()
        self.reminders = []
        self.running = True
        self.check_thread = threading.Thread(target=self._check_reminders)
        self.check_thread.daemon = True
        self.check_thread.start()
    
    def add_reminder(self, message, minutes):
        reminder_time = time.time() + minutes * 60
        self.reminders.append((reminder_time, message))
        print(f"提醒已設(shè)置: '{message}' 將在 {minutes} 分鐘后提醒")
    
    def _check_reminders(self):
        while self.running:
            current_time = time.time()
            # 檢查是否有到期的提醒
            for i, (reminder_time, message) in enumerate(self.reminders[:]):
                if current_time >= reminder_time:
                    print(f"提醒: {message}")
                    self.engine.say(message)
                    self.engine.runAndWait()
                    # 刪除已觸發(fā)的提醒
                    self.reminders.pop(i)
            time.sleep(1)
    
    def stop(self):
        self.running = False
        self.check_thread.join(timeout=1)

# 使用示例
reminder = VoiceReminder()
reminder.add_reminder("該喝水了", 0.1)  # 6秒后提醒
reminder.add_reminder("休息一下眼睛", 0.2)  # 12秒后提醒

# 保持程序運行足夠長的時間來觸發(fā)提醒
time.sleep(15)
reminder.stop()