SpeechSynthesizer 类

定义

命名空间:System.Speech.Synthesis

程序集:System.Speech.dll

包:System.Speech v9.0.0-rc.1.24431.7

Source:SpeechSynthesizer.cs

示例

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
using System;
using System.Speech.Synthesis;

namespace SampleSynthesis
{
  class Program
  {
    static void Main(string[] args)
    {

      // Initialize a new instance of the SpeechSynthesizer.
      SpeechSynthesizer synth = new SpeechSynthesizer();

      // Configure the audio output.
      synth.SetOutputToDefaultAudioDevice();

      // Speak a string.
      synth.Speak("This example demonstrates a basic use of Speech Synthesizer");

      Console.WriteLine();
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }
  }
}

注解

创建新 SpeechSynthesizer 对象时，它使用默认的系统语音。 若要将 配置为 SpeechSynthesizer 使用已安装的语音合成 (文本转语音) 语音之一，请使用 SelectVoice 或 SelectVoiceByHints 方法。 若要获取有关已安装哪些语音的信息，请使用 GetInstalledVoices 方法和 VoiceInfo 类。

此类还提供对语音合成的以下方面的控制：

  • 若要配置 SpeechSynthesizer 对象的输出，请使用 SetOutputToAudioStream、 SetOutputToDefaultAudioDevice、 SetOutputToNull和 SetOutputToWaveFile 方法。
  • 若要生成语音，请使用 Speak、 SpeakAsync、 SpeakSsml或 SpeakSsmlAsync 方法。 SpeechSynthesizer可以从文本、Prompt或 PromptBuilder 对象或语音合成标记语言 (SSML) 版本 1.0 生成语音。
  • 若要暂停和恢复语音合成，请使用 Pause 和 Resume 方法。
  • 若要添加或删除词典，请使用 AddLexicon 和 RemoveLexicon 方法。 SpeechSynthesizer可以使用一个或多个词典来指导其字词的发音。
  • 若要修改语音输出的传递，请使用 Rate 和 Volume 属性。

遇到提示中的某些功能时，会 SpeechSynthesizer 引发事件：(BookmarkReached、 PhonemeReached、 VisemeReached和 SpeakProgress) 。
它还引发事件，报告说话操作的开始 (SpeakStarted) 和结束 (SpeakCompleted) 以及语音 (VoiceChange ) 的变化。

工具类

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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
/// <summary>
/// 讲述人
/// </summary>
public class SpeakerHelper
{
    private static SpeakerHelper instance;
    private SpeechSynthesizer synth = new SpeechSynthesizer();
    /// <summary>
    /// 讲述人实例
    /// </summary>
    public static SpeakerHelper Instance
    {
        get
        {
            if (instance == null)
            {
                instance = new SpeakerHelper();
            }
            return instance;
        }
    }

    /// <summary>
    /// 获取已安装的音色
    /// </summary>
    /// <returns></returns>
    public ReadOnlyCollection<InstalledVoice> GetPlayerEffects()
    { 
        return synth.GetInstalledVoices();
    }

    /// <summary>
    /// 朗读
    /// </summary>
    /// <param name="textToSpeak">内容</param>
    /// <param name="rate">语速从-10 到 10</param>
    public void Speak(string textToSpeak, int rate = -5)
    {
        try
        {
            if (string.IsNullOrEmpty(textToSpeak) == false)
            {
                // Initialize a new instance of the SpeechSynthesizer. 
                // Configure the audio output. 
                synth.SetOutputToDefaultAudioDevice();
                
                // 语速从-10 到 10。
                synth.Rate = rate;
                // Speak a string synchronously.
                synth.Speak(textToSpeak); 
            }
        }
        catch (Exception ex)
        {
            throw ex;
        }
    }

    /// <summary>
    /// 设置音量
    /// </summary>
    /// <param name="playerVolume"></param>
    public void SetPlayerVolume(int playerVolume)
    {
        synth.Volume = playerVolume;
    }
}

备注

  • 安装的音色似乎与系统安装的语言语音包有关

参考文献