在C#开发中,实现文字转语音播报功能可以借助.NET框架内置的SpeechSynthesizer类,该类位于System.Speech.Synthesis命名空间下,无需引入第三方依赖就能完成基础的语音合成与播报操作,适合大多数常规场景的需求。

环境准备与基础使用
首先需要在项目中添加对应的程序集引用,在Visual Studio中右键项目选择添加引用,找到System.Speech组件勾选即可。如果是.NET Core及以上版本,需要通过NuGet安装System.Speech.Synthesis包。
最基础的文字播报只需要几行代码就能实现,示例如下:
using System;
using System.Speech.Synthesis;
namespace TextToSpeechDemo
{
class Program
{
static void Main(string[] args)
{
// 创建语音合成器实例
SpeechSynthesizer synthesizer = new SpeechSynthesizer();
// 调用Speak方法直接播报文字内容
synthesizer.Speak("欢迎使用文字转语音功能");
Console.WriteLine("播报完成");
}
}
}
常用属性配置
SpeechSynthesizer提供了多个可配置属性,可以调整播报的效果,常用的配置项如下:
- Rate:语速,取值范围是-10到10,数值越大语速越快,默认值为0
- Volume:音量,取值范围是0到100,默认值为100
- Voice:当前使用的发音人,可通过GetInstalledVoices方法获取系统已安装的发音人
调整语速和音量的示例代码如下:
using System;
using System.Speech.Synthesis;
namespace TextToSpeechDemo
{
class Program
{
static void Main(string[] args)
{
SpeechSynthesizer synthesizer = new SpeechSynthesizer();
// 设置语速为5,比默认语速稍快
synthesizer.Rate = 5;
// 设置音量为80
synthesizer.Volume = 80;
synthesizer.Speak("当前语速和音量已调整");
}
}
}
选择系统发音人
不同系统预装的发音人不同,我们可以通过代码获取所有可用的发音人,然后根据需求选择对应的发音人,示例代码如下:
using System;
using System.Speech.Synthesis;
namespace TextToSpeechDemo
{
class Program
{
static void Main(string[] args)
{
SpeechSynthesizer synthesizer = new SpeechSynthesizer();
// 获取所有已安装的发音人
var voices = synthesizer.GetInstalledVoices();
Console.WriteLine("系统已安装的发音人:");
foreach (var voice in voices)
{
Console.WriteLine($"名称:{voice.VoiceInfo.Name},描述:{voice.VoiceInfo.Description}");
}
// 选择第一个发音人(如果存在)
if (voices.Count > 0)
{
synthesizer.SelectVoice(voices[0].VoiceInfo.Name);
synthesizer.Speak("已切换发音人,这是新的发音效果");
}
}
}
}
异步播报与语音保存
默认的Speak方法是同步的,会阻塞当前线程直到播报完成,如果需要异步播报可以使用SpeakAsync方法。另外还可以将合成的语音保存为文件,方便后续重复使用,相关示例如下:
using System;
using System.Speech.Synthesis;
namespace TextToSpeechDemo
{
class Program
{
static void Main(string[] args)
{
SpeechSynthesizer synthesizer = new SpeechSynthesizer();
// 异步播报,不会阻塞主线程
synthesizer.SpeakAsync("这是异步播报的内容,主线程可以继续执行其他操作");
Console.WriteLine("异步播报已启动,主线程继续执行");
// 将语音保存为WAV文件
synthesizer.SetOutputToWaveFile("output.wav");
synthesizer.Speak("这段内容会被保存为音频文件");
// 恢复输出到默认音频设备
synthesizer.SetOutputToDefaultAudioDevice();
Console.WriteLine("语音文件保存完成");
}
}
}
注意事项
使用SpeechSynthesizer时需要注意,部分精简版系统可能没有预装语音引擎,此时调用相关方法会抛出异常,建议在使用前先判断发音人列表是否为空。另外如果是服务器端应用使用,需要注意系统音频设备的配置,避免出现无法播报的问题。
C#SpeechSynthesizer文字转语音语音合成修改时间:2026-07-23 17:57:23