SpeechSynthesizer.SpeakSsmlAsync(String) Methode

public:
 System::Speech::Synthesis::Prompt ^ SpeakSsmlAsync(System::String ^ textToSpeak);

public System.Speech.Synthesis.Prompt SpeakSsmlAsync(string textToSpeak);

member this.SpeakSsmlAsync : string -> System.Speech.Synthesis.Prompt

Public Function SpeakSsmlAsync (textToSpeak As String) As Prompt

Parameters

Retouren

Het object dat de inhoud bevat die moet worden uitgesproken.

Uitzonderingen

Voorbeelden

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

      // Build an SSML prompt in a string.
      string str = "<speak version=\"1.0\"";
      str += " xmlns=\"http://www.w3.org/2001/10/synthesis\"";
      str += " xml:lang=\"en-US\">";
      str += "<say-as type=\"date:mdy\"> 1/29/2009 </say-as>";
      str += "</speak>";

      // Speak the contents of the prompt asynchronously.
      synth.SpeakSsmlAsync(str);

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

Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door SpeakSsml(String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.

Opmerkingen

De inhoud van de textToSpeak parameter moet een speak element bevatten en moet voldoen aan de SSML-versie (Speech Synthesis Markup Language) versie 1.0. Zie Speech Synthesis Markup Language Reference voor meer informatie.

Als u synchroon een tekenreeks wilt uitspreken die SSML-markeringen bevat, gebruikt u de SpeakSsml methode. U kunt SpeakAsync het asynchrone spreken van een tekenreeks die geen SSML-opmaak bevat, initiëren.

Tijdens een aanroep van deze methode kan de SpeechSynthesizer volgende gebeurtenissen worden gegenereerd:

• StateChanged. Verhoogd wanneer de spreektoestand van de synthesizer verandert.

• SpeakStarted. Verhoogd wanneer de synthesizer begint met het genereren van spraak.

• PhonemeReached. Telkens wanneer de synthesizer een letter of combinatie van letters bereikt die een discreet geluid van spraak in een taal vormen.

• SpeakProgress. Steeds wanneer de synthesizer klaar is met het spreken van een woord.

• VisemeReached. Elke keer dat gesproken uitvoer wordt gegenereerd, is een verandering in de positie van de mond of de gezichtsspieren vereist die worden gebruikt om spraak te produceren.

• BookmarkReached. Verhoogd wanneer de synthesizer een bladwijzer tegenkomt in een prompt.

• VoiceChange. Opgevoed wanneer de gesproken stem voor de synthesizer verandert.

• SpeakCompleted. Verhoogd wanneer de synthesizer klaar is met het verwerken van een SpeakSsmlAsync bewerking.

Als uw toepassing tijdens het spreken geen taken hoeft uit te voeren, kunt u de Speak of de SpeakSsml methode gebruiken om spraak synchroon te genereren.