SpeechSynthesizer 类

定义

命名空间:

Windows.Media.SpeechSynthesis

为文本转语音 (TTS) 服务提供对已安装语音合成引擎 (语音) 的访问。

public ref class SpeechSynthesizer sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class SpeechSynthesizer final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SpeechSynthesizer : System.IDisposable

function SpeechSynthesizer()

Public NotInheritable Class SpeechSynthesizer
Implements IDisposable

继承

Object Platform::Object IInspectable SpeechSynthesizer

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下示例演示如何从基本文本字符串生成语音音频流。

// The media object for controlling and playing audio.
MediaElement mediaElement = this.media;

// The object for controlling the speech synthesis engine (voice).
var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();

// Generate the audio stream from plain text.
SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello World");

// Send the stream to the media object.
mediaElement.SetSource(stream, stream.ContentType);
mediaElement.Play();

// The object for controlling the speech synthesis engine (voice).
synth = ref new SpeechSynthesizer();
// The media object for controlling and playing audio.
media = ref new MediaElement();
// The string to speak.
String^ text = "Hello World";

// Generate the audio stream from plain text.
task<SpeechSynthesisStream ^> speakTask = create_task(synth->SynthesizeTextToStreamAsync(text));
speakTask.then([this, text](SpeechSynthesisStream ^speechStream)
{
    // Send the stream to the media object.
    // media === MediaElement XAML object.
    media->SetSource(speechStream, speechStream->ContentType);
    media->AutoPlay = true;
    media->Play();
});

此示例演示如何从 SSML 字符串生成语音音频流，该字符串包括一些控制语音输出音调、语速和音量的调节元素。

// The string to speak with SSML customizations.
string Ssml =
    @"<speak version='1.0' " +
    "xmlns='http://www.w3.org/2001/10/synthesis' xml:lang='en-US'>" +
    "Hello <prosody contour='(0%,+80Hz) (10%,+80%) (40%,+80Hz)'>World</prosody> " + 
    "<break time='500ms'/>" +
    "Goodbye <prosody rate='slow' contour='(0%,+20Hz) (10%,+30%) (40%,+10Hz)'>World</prosody>" +
    "</speak>";

// The media object for controlling and playing audio.
MediaElement mediaElement = this.media;

// The object for controlling the speech synthesis engine (voice).
var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();

// Generate the audio stream from plain text.
SpeechSynthesisStream stream = await synth.synthesizeSsmlToStreamAsync(Ssml);

// Send the stream to the media object.
mediaElement.SetSource(stream, stream.ContentType);
mediaElement.Play();

// The object for controlling the speech synthesis engine (voice).
synth = ref new SpeechSynthesizer();
// The media object for controlling and playing audio.
media = ref new MediaElement();
// The string to speak.
String^ ssml =
    "<speak version='1.0' "
    "xmlns='http://www.w3.org/2001/10/synthesis' xml:lang='en-US'>"
    "Hello <prosody contour='(0%,+80Hz) (10%,+80%) (40%,+80Hz)'>World</prosody>"
    "<break time='500ms' /> "
    "Goodbye <prosody rate='slow' contour='(0%,+20Hz) (10%,+30%) (40%,+10Hz)'>World</prosody>"
    "</speak>";

// Generate the audio stream from SSML.
task<SpeechSynthesisStream ^> speakTask = create_task(synth->SynthesizeSsmlToStreamAsync(ssml));
speakTask.then([this, ssml](SpeechSynthesisStream ^speechStream)
{
    // Send the stream to the media object.
    // media === MediaElement XAML object.
    media->SetSource(speechStream, speechStream->ContentType);
    media->AutoPlay = true;
    media->Play();
});

注解

只有安装在系统上的 Microsoft 签名语音才能用于生成语音。

Windows 包括各种 Microsoft 签名的语音，可用于多种语言。 每个语音生成单一语言的合成语音，就像在特定国家/地区一样。

默认情况下，新的 SpeechSynthesizer 对象使用当前系统语音 (调用 DefaultVoice 来找出默认语音) 。

若要指定安装在用户系统上 (文本转语音) 语音的其他语音合成，请使用 Voice 方法 (找出系统上安装了哪些 语音 ，请调用 AllVoices) 。

如果未指定语言，则会加载与语言控制面板中选择的语言最接近的语音。

使用 SpeechSynthesizer 对象可以：

• 使用 SynthesizeTextToStreamAsync 从纯文本生成语音，或使用 SynthesizeSsmlToStreamAsync (SSML) 版本 1.1 中的语音合成标记语言 (
• 生成的音频流通过 MediaElement 对象) 播放，这使你可以管理所有媒体播放。
• 使用通过 SpeechSynthesizer.Options 公开的各种 SpeechSynthesizerOptions 设置控制 语音输出。

版本历史记录

Windows 版本	SDK 版本	已添加值
1703	15063	选项
1709	16299	TrySetDefaultVoiceAsync

构造函数

SpeechSynthesizer()

初始化 SpeechSynthesizer 对象的新实例。

属性

AllVoices	获取所有已安装语音合成引擎 (语音) 的集合。
DefaultVoice	获取默认语音合成引擎 (语音) 。
Options	获取对可在 SpeechSynthesizer 对象上设置的选项集合的引用。
Voice	获取或设置语音合成引擎 (语音) 。

方法

Close()	关闭 SpeechSynthesizer 并释放系统资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
SynthesizeSsmlToStreamAsync(String)	从语音 合成标记语言 (SSML) 版本 1.1 字符串异步生成和控制语音输出。
SynthesizeTextToStreamAsync(String)	从字符串异步生成语音输出。
TrySetDefaultVoiceAsync(VoiceInformation)	异步尝试在 IoT 设备上设置用于语音合成的语音。 注意 此方法仅在 嵌入模式下可用。

另请参阅

• Windows.Media.SpeechSynthesis
• IClosable
• VoiceInformation
• 语音交互
• 语音识别和语音合成示例
• 全息语音输入示例