PromptBuilder.AppendTextWithPronunciation(String, String) PromptBuilder.AppendTextWithPronunciation(String, String) PromptBuilder.AppendTextWithPronunciation(String, String) PromptBuilder.AppendTextWithPronunciation(String, String) Method

Definición

Anexa texto al objeto PromptBuilder y especifica la pronunciación del texto.Appends text to the PromptBuilder object and specifies the pronunciation for the text.

public:
 void AppendTextWithPronunciation(System::String ^ textToSpeak, System::String ^ pronunciation);
public void AppendTextWithPronunciation (string textToSpeak, string pronunciation);
member this.AppendTextWithPronunciation : string * string -> unit
Public Sub AppendTextWithPronunciation (textToSpeak As String, pronunciation As String)

Parámetros

textToSpeak
String String String String

Cadena que contiene la forma escrita de la palabra usando el alfabeto convencional para un idioma.A string containing the written form of the word using the conventional alphabet for a language.

pronunciation
String String String String

Cadena que contiene los teléfonos que se dirán con el alfabeto fonético internacional (IPA).A string containing phones to be spoken from the International Phonetic Alphabet (IPA).

Ejemplos

En el ejemplo siguiente se inicializa una nueva instancia de la PromptBuilder clase.The following example initializes a new instance of the PromptBuilder class. Luego anexa la cadena de texto "My name is" a la instancia.It then appends the text string "My name is" to the instance. Por último, se anexa una cadena que contiene el nombre correcto "DuBois" y especifica la pronunciación del nombre.Finally, it appends a string containing the proper name "DuBois" and specifies the pronunciation of the name.

public void ProperName()  
{  
    PromptBuilder builder = new PromptBuilder();  
    builder.AppendText("My name is");  

    // Add a proper name and its pronunciation.  
    builder.AppendTextWithPronunciation("DuBois", "duˈbwɑ");     
}  

El marcado siguiente muestra el SSML que PromptBuilder genera el objeto.The following markup shows the SSML that this PromptBuilder object generates.

<speak xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="en-us">  
  My name is <phoneme ph="duˈbwɑ"> DuBois </phoneme>  
</speak>  

Comentarios

El sintetizador habla el contenido de la pronunciation parámetro, no el contenido de la textToSpeak parámetro.The synthesizer speaks the contents of the pronunciation parameter, not the contents of the textToSpeak parameter.

Pronunciaciones especificarse insertados en los mensajes solo se aplican a la aparición de una palabra individual y reemplazar las pronunciaciones del motor de voz o cualquiera de sus léxicos actualmente activos.Pronunciations specified inline in prompts apply only to the individual occurrence of a word and override pronunciations of the speech engine or any of its currently active lexicons. Normalmente, usará las pronunciaciones en línea para pronunciaciones personalizadas de palabras existentes o para la pronunciación de palabras poco comunes, como nombres propios, lo que el motor de síntesis de voz no puede pronunciar como se esperaba.Typically, you will use inline pronunciations for custom pronunciations of existing words or for pronunciation of uncommon words, such as proper names, which the speech synthesis engine may not pronounce as well as expected.

Deben especificarse en línea pronunciaciones mediante teléfonos del alfabeto fonético internacional (IPA).Inline pronunciations must be specified using phones from the International Phonetic Alphabet (IPA). Un teléfono es una letra o un carácter que representa un sonido discreto de voz.A phone is a letter or character that represents a discreet sound of speech. Los motores de voz que cumplen con la lenguaje de marcado de síntesis de voz (SSML) versión 1.0 especificación pronuncie teléfonos desde el archivo IPA.Speech engines that comply with the Speech Synthesis Markup Language (SSML) Version 1.0 specification will pronounce phones from the IPA. Para especificar pronunciaciones en línea con otros alfabetos fonéticos, vea AppendSsmlMarkup.To specify inline pronunciations using other phonetic alphabets, see AppendSsmlMarkup.

El archivo IPA se publica un gráfico que se enumeran sus teléfonos y los asigna a los números de Unicode.The IPA publishes a chart that lists its phones and maps them to Unicode numbers.

Algunos teléfonos del alfabeto IPA tienen las mismas representaciones como letras del alfabeto latino.Some phones in the IPA alphabet have the same representations as letters in the Latin alphabet. En esos casos, es posible escribir los caracteres latinos y tienen la representación adecuada para un teléfono.In those cases, it is possible to type the Latin character and have the proper representation for a phone. Dado que los caracteres latinos utilizados normalmente en texto pueden representar varios teléfonos del conjunto de phone IPA, simplemente escribiendo los caracteres latinos podría no producir el teléfono IPA preciso deseado.Because the Latin characters as commonly used in text may represent several phones of the IPA phone set, simply typing the Latin character might not result in the precise IPA phone desired. Otros teléfonos de la necesidad de alfabeto IPA para representarse en el código como carácter de referencias que consta de una y comercial (&), la almohadilla (#), y un número de Unicode para el teléfono en formato hexadecimal o decimal, deseado todos seguido por un punto y coma (;).Other phones of the IPA alphabet need to be represented in code as character references consisting of an ampersand (&), the number sign (#), and a Unicode number for the desired phone in hexadecimal or decimal, all followed by a semicolon (;). Por ejemplo, un schwa (&#x0259;) se representaría mediante &#x0259;.For example, a schwa (&#x0259;) would be represented by &#x0259;.

Para agregar las pronunciaciones nuevas o personalizadas para varias palabras, por ejemplo a dialectos express regionales o para agregar nombres propios o vocabulario que es específico de una disciplina educativa o médica, generar un léxico y agregarlo a la SpeechSynthesizer mediante AddLexicon.To add new or custom pronunciations for multiple words, for example to express regional dialects or to add proper names or vocabulary that is specific to an educational or medical discipline, build a lexicon and add it to the SpeechSynthesizer using AddLexicon.

Se aplica a

Consulte también: