SpeakProgressEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve datos del SpeakProgress evento.
public ref class SpeakProgressEventArgs : System::Speech::Synthesis::PromptEventArgs
public class SpeakProgressEventArgs : System.Speech.Synthesis.PromptEventArgs
type SpeakProgressEventArgs = class
inherit PromptEventArgs
Public Class SpeakProgressEventArgs
Inherits PromptEventArgs
- Herencia
Ejemplos
En el ejemplo siguiente se muestra la información disponible en SpeakProgressEventArgs. Tenga en cuenta cómo afectan CharacterCount los StartParagraphmétodos , StartSentenceEndParagraph, y EndSentence mediante su adición de <etiquetas p>, </p>, <s> y </s> al SSML generado. Además, hay dos entradas en la salida para "30%", una para cada palabra para hablar esta cadena de número (treinta por ciento). y CharacterCountCharacterPosition son los mismos para cada entrada y representan los caracteres "30%. Sin embargo, los AudioPosition cambios para reflejar el habla de las palabras "treinta" y "porcentaje" por .SpeechSynthesizer
using System;
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.SetOutputToWaveFile(@"C:\test\weather.wav");
// Create a SoundPlayer instance to play the output audio file.
System.Media.SoundPlayer m_SoundPlayer =
new System.Media.SoundPlayer(@"C:\test\weather.wav");
// Build a prompt containing a paragraph and two sentences.
PromptBuilder builder = new PromptBuilder(
new System.Globalization.CultureInfo("en-US"));
builder.StartParagraph();
builder.StartSentence();
builder.AppendText(
"The weather forecast for today is partly cloudy with some sun breaks.");
builder.EndSentence();
builder.StartSentence();
builder.AppendText(
"Tonight's weather will be cloudy with a 30% chance of showers.");
builder.EndSentence();
builder.EndParagraph();
// 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);
m_SoundPlayer.Play();
}
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("CharPos: {0} CharCount: {1} AudioPos: {2} \"{3}\"",
e.CharacterPosition, e.CharacterCount, e.AudioPosition, e.Text);
}
}
}
Comentarios
Se crea una instancia de SpeakProgressEventArgs cuando el SpeechSynthesizer objeto genera el SpeakProgress evento. SpeechSynthesizer genera este evento para cada palabra nueva que habla en un símbolo del sistema mediante cualquiera de los Speakmétodos , SpeakAsync, SpeakSsmlo SpeakSsmlAsync .
Los datos devueltos se basan en el lenguaje de marcado de síntesis de voz (SSML) que genera el código. Los valores devueltos para CharacterCount incluir espacios y los caracteres y el contenido de las etiquetas SSML generadas por el código.
Propiedades
| Nombre | Description |
|---|---|
| AudioPosition |
Obtiene la posición de audio del evento. |
| Cancelled |
Obtiene un valor que indica si se ha cancelado una operación asincrónica. (Heredado de AsyncCompletedEventArgs) |
| CharacterCount |
Obtiene el número de caracteres de la palabra que se habló justo antes de que se generara el evento. |
| CharacterPosition |
Obtiene el número de caracteres y espacios desde el principio del símbolo del sistema hasta la posición anterior a la primera letra de la palabra que se acaba de hablar. |
| Error |
Obtiene un valor que indica qué error se produjo durante una operación asincrónica. (Heredado de AsyncCompletedEventArgs) |
| Prompt |
Obtiene el símbolo del sistema asociado al evento. (Heredado de PromptEventArgs) |
| Text |
Texto que se acaba de decir cuando se generó el evento. |
| UserState |
Obtiene el identificador único de la tarea asincrónica. (Heredado de AsyncCompletedEventArgs) |
Métodos
| Nombre | Description |
|---|---|
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| RaiseExceptionIfNecessary() |
Genera una excepción proporcionada por el usuario si se produjo un error en una operación asincrónica. (Heredado de AsyncCompletedEventArgs) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |