SpeakProgressEventArgs.CharacterPosition 屬性

定義

命名空間:

System.Speech.Synthesis

組件:

System.Speech.dll

套件:

System.Speech v9.0.0-preview.4.24266.19

來源:

SpeakProgressEventArgs.cs

取得從提示開頭到剛說出的文字的第一個字母之前位置的字元和空格數。

public:
 property int CharacterPosition { int get(); };

public int CharacterPosition { get; }

member this.CharacterPosition : int

Public ReadOnly Property CharacterPosition As Integer

屬性值

Int32

傳回從提示開頭到剛說出的文字的第一個字母之前位置的字元和空格數。

範例

下列範例會 PromptBuilder 建立 ，並使用 附加 XML 檔案 XmlReader 的 SSML 內容。 此範例會將語音輸出至 WAV 檔案以供播放。 包含 SSML 的 XML 檔案內容會出現在程式碼範例下方。

using System;  
using System.Xml;  
using System.IO;  
using System.Speech.Synthesis;  

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

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

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

        // Create a path to the file that contains SSML.  
        string weatherFile = Path.GetFullPath("c:\\test\\Weather.ssml");  

        // Create an XML Reader from the file, create a PromptBuilder and   
        // append the XmlReader.  
        PromptBuilder builder = new PromptBuilder();  

        if (File.Exists(weatherFile))  
        {  
          XmlReader reader = XmlReader.Create(weatherFile);  
          builder.AppendSsml(reader);  
          reader.Close();  
        }  

        // Add a handler for the SpeakProgress event.  
        synth.SpeakProgress +=  
          new EventHandler<SpeakProgressEventArgs>(synth_SpeakProgress);  

        // Speak the prompt and play back the output file.  
        synth.Speak(builder);  
      }  

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

    // Write each word and its character position to the console.  
    static void synth_SpeakProgress(object sender, SpeakProgressEventArgs e)  
    {  
      Console.WriteLine("Speak progress: {0} {1}",  
        e.CharacterPosition, e.Text);  
    }  
  }  
}  

<!-- The following are the contents of the file Weather.ssml.   
Note that because of the <p> tag and the space that follows it,   
that the character position of the first word "The" will be 86. -->  

<?xml version="1.0" encoding="ISO-8859-1"?>  
<speak version="1.0"  
 xmlns="http://www.w3.org/2001/10/synthesis"  
 xml:lang="en-US">  

  <p> The weather forecast for today is partly cloudy with   
some sun breaks. </p>  

  <break strength="medium" />  

  <p> Tonight's weather will be cloudy with a 30% chance of   
showers. </p>  

</speak>  

備註

CharacterPosition包含 XML 標記中字元的計數，包括其括住括弧。 使用任何 AppendText 、 AppendTextWithAlias 、 AppendTextWithHint 、 AppendSsmlMarkup 或 AppendTextWithPronunciation 方法時，內容會新增至包含開頭和結尾 speak 專案的 SSML 提示字元。 開頭 speak 元素會將 82 個字元和空格的位移新增至 CharacterPosition 提示中所有單字和字母的 。 例如，在下列程式碼片段中， CharacterPosition 第一個字 「this」 的 是 82。

builder.AppendText("This is a test");  
Synthesizer.Speak(builder);  

在上述範例中， CharacterPosition 「test」 這個字的 是 92。 在下列程式碼片段中， CharacterPosition 「test」 這個字組的 23 個字元較高， (115) ，因為< 開頭音調=「high」 >標籤前面包含 23 個字元，且空格 (兩個逸出字元 「\」 不會計入) 。

builder.AppendSsmlMarkup("This is a <prosody pitch=\"high\"> test </prosody>.");   
Synthesizer.Speak(builder);  

如果您使用 AppendSsml 方法來藉由指定檔案將內容新增至提示，則不會使用或計算檔案中的開啟 xml 宣告和 speak 元素。 如果檔案是提示中的第一個內容，則開頭 speak 標記後面的第一個字元會位於位置 82。

相較之下，方法的 Speak 字串參數不會在說出之前新增至 SSML 提示字元。 因此， CharacterPosition 下列程式碼片段中第一個字 「this」 的 為零。

Synthesizer.Speak("This is a test.");  

會將 SpeechSynthesizer 數位正規化為對應到數位讀出方式的字組。 例如，合成器會將數位 「4003」 讀為 「four thousand three」。 它會針對三個 SpeakProgress 口語文字的每個引發事件。 不過， CharacterPosition 這三個單字的每一個屬性都相同。 這是提示文字中數位 「4003」 第一個字元之前的位置。