核心内容摘要
实战分享：用Ollama玩转Llama-3.2-3B多语言文本生成
引用开发环境Visual Studio任意支持.NET
5 的版本 VS2022项目配置创建控制台应用程序.NET Framework
5引用程序集System.Speech不是默认引用需要手动添加右键项目 → 「添加」→ 「引用」切换到「程序集」→ 「框架」勾选System.Speech→ 「确定」
代码实现了基本语音播报、自定义语速 / 音量、中文播报三个核心功能包含异常处理避免运行报错。
using System; using System.Speech.Synthesis; // 核心命名空间提供语音合成功能 namespace SpeechBroadcastDemo { class Program { static void Main(string[] args) { // 实例化语音合成器核心类负责语音播报的所有操作 using (SpeechSynthesizer synthesizer new SpeechSynthesizer()) { try { // ------------- 可选配置自定义语音参数 ------------- //
设置音量
默认100 synthesizer.Volume 80; //
设置语速-10到10默认0数值越大语速越快负数放慢 synthesizer.Rate 0; //
选择中文语音若系统没有中文语音包会使用默认语音通常是英文 // 优先选择中文简体语音引擎 synthesizer.SelectVoiceByHints(VoiceGender.Neutral, VoiceAge.Adult, 0, System.Globalization.CultureInfo.GetCultureInfo(zh-CN)); // ------------- 核心功能语音播报 ------------- Console.WriteLine(开始语音播报...); // 方式1同步播报阻塞线程直到播报完成才执行后续代码 string broadcastContent 你好这是基于.NET
5的语音播报测试当前舌头涩的症状可以通过食用梨、甘蔗等水果缓解。
; synthesizer.Speak(broadcastContent); // 方式2异步播报不阻塞线程播报同时可以执行其他代码 // synthesizer.SpeakAsync(这是异步语音播报不会阻塞控制台后续操作。
); // 异步播报时可通过 synthesizer.SpeakAsyncCancel() 取消播报 Console.WriteLine(语音播报完成); } catch (Exception ex) { Console.WriteLine($语音播报失败错误信息{ex.Message}); Console.WriteLine(提示请检查系统是否安装了语音包或是否正确引用了System.Speech程序集。
); } Console.ReadLine(); } } } }
关键代码解释SpeechSynthesizer类这是System.Speech命名空间的核心类负责创建语音合成实例提供音量、语速设置和播报功能使用using语句包裹可自动释放资源避免内存泄漏。
SelectVoiceByHints方法用于选择指定类型的语音引擎这里指定了「中文简体」确保能播报中文内容。
如果你的 Windows 系统没有安装中文语音包会自动使用系统默认语音通常是英文此时中文内容会播报为乱码或无法识别。
Speak()与SpeakAsync()Speak()同步播报阻塞当前线程适合简单的、无需并行执行其他操作的场景。
SpeakAsync()异步播报不阻塞当前线程适合需要在播报同时执行其他逻辑如界面操作、数据处理的场景。
异常处理捕获可能出现的错误如无语音引擎、程序集引用失败等并给出明确提示方便排查问题。
补充说明若无法播报中文打开「控制面板」→ 「轻松使用」→ 「语音识别」→ 「文本到语音转换」查看「语音选择」是否有中文选项如「微软慧涛」「微软小云」若无则需要下载安装中文语音包。
该方案仅支持Windows 系统System.Speech依赖 Windows 自带的语音引擎Linux 或 macOS 系统无法运行若需要跨平台需使用第三方库如NAudio配合第三方 TTS 引擎。
如需更复杂的语音合成如保存语音为 WAV 文件可添加synthesizer.SetOutputToWaveFile(D:\语音播报保存.wav);放在播报前即可将语音内容保存为音频文件。
总结.NET
5 语音播报优先使用System.Speech程序集无需第三方依赖仅支持 Windows 环境。
核心步骤为「添加程序集引用」→ 「实例化SpeechSynthesizer」→ 「配置参数」→ 「调用Speak()/SpeakAsync()播报」。
中文播报需确保系统安装了中文语音包否则会使用默认英文语音引擎导致中文无法正常播报。