SpeechSynthesizer Klasse

Definition

public ref class SpeechSynthesizer sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SpeechSynthesizer final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SpeechSynthesizer : System.IDisposable

[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

Vererbung

Object Platform::Object IInspectable SpeechSynthesizer

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

Beispiele

Das folgende Beispiel zeigt, wie Sie einen Sprachaudiodatenstrom aus einer einfachen Textzeichenfolge generieren.

// 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();
});

In diesem Beispiel wird gezeigt, wie Sie einen Sprachaudiodatenstrom aus einer SSML-Zeichenfolge generieren, der einige Modulationselemente enthält, die die Tonhöhe, Sprechrate und Lautstärke der Sprachausgabe steuern.

// 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();
});

Hinweise

Nur von Microsoft signierte Stimmen, die auf dem System installiert sind, können zum Generieren von Sprache verwendet werden.

Windows enthält verschiedene von Microsoft signierte Stimmen, die für eine Reihe von Sprachen verwendet werden können. Jede Stimme generiert synthetisierte Sprache in einer einzelnen Sprache, die in einem bestimmten Land/einer bestimmten Region gesprochen wird.

Standardmäßig verwendet ein neues SpeechSynthesizer-Objekt die aktuelle Systemstimme (rufen Sie DefaultVoice auf, um herauszufinden, was die Standardstimme ist).

Verwenden Sie die Voice-Methode ( um herauszufinden, welche Stimmen auf dem System des Benutzers installiert sind) (um herauszufinden, welche Stimmen auf dem System installiert sind, rufen Sie AllVoices auf).

Wenn Sie keine Sprache angeben, wird die Stimme geladen, die der in der Sprachsteuerung ausgewählten Sprache am ehesten entspricht.

Verwenden Sie ein SpeechSynthesizer-Objekt für Folgendes:

• Generieren von Sprache aus Nur-Text mit SynthesizeTextToStreamAsync oder Speech Synthesis Markup Language (SSML) Version 1.1 mithilfe von SynthesizeSsmlToStreamAsync (
• Der generierte Audiodatenstrom wird über ein MediaElement-Objekt wiedergegeben, mit dem Sie die gesamte Medienwiedergabe verwalten können.
• Steuern Sie die Sprachausgabe mit den verschiedenen SpeechSynthesizerOptions-Einstellungen , die über SpeechSynthesizer.Options verfügbar gemacht werden.

Versionsverlauf

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• Windows.Media.SpeechSynthesis
• IClosable
• VoiceInformation
• Sprachinteraktionen
• Beispiel zu Spracherkennung und Sprachsynthese
• Beispiel für holografische Spracheingabe