Partilhar via


PromptBuilder.AppendTextWithPronunciation(String, String) Método

Definição

Acrescenta texto ao objeto PromptBuilder e especifica a pronúncia do texto.

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

Uma cadeia de caracteres que contém a forma escrita da palavra usando o alfabeto convencional para um idioma.

pronunciation
String

Uma cadeia de caracteres que contém os fonemas do IPA (alfabeto fonético internacional) a pronunciar.

Exemplos

O exemplo a seguir inicializa uma nova instância da PromptBuilder classe . Em seguida, acrescenta a cadeia de texto "Meu nome é" à instância. Por fim, ele acrescenta uma cadeia de caracteres que contém o nome apropriado "DuBois" e especifica a pronúncia do nome.

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

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

A marcação a seguir mostra o SSML gerado por esse PromptBuilder objeto.

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

Comentários

O sintetizador fala o conteúdo do pronunciation parâmetro, não o conteúdo do textToSpeak parâmetro.

Pronúncias especificadas embutidas em prompts se aplicam apenas à ocorrência individual de uma palavra e substituem pronúncias do mecanismo de fala ou de qualquer um de seus léxicos ativos no momento. Normalmente, você usará pronúncias embutidas para pronúncias personalizadas de palavras existentes ou para pronúncia de palavras incomuns, como nomes adequados, que o mecanismo de síntese de fala pode não pronunciar tão bem quanto o esperado.

Pronúncias embutidas devem ser especificadas usando telefones do IPA (Alfabeto Fonético Internacional). Um telefone é uma letra ou caractere que representa um som discreto de fala. Os mecanismos de fala que cumprem a especificação SSML (Linguagem de Marcação de SSML) de Fala versão 1.0 pronunciarão telefones do IPA. Para especificar pronúncias embutidas usando outros alfabetos fonéticos, consulte AppendSsmlMarkup.

O IPA publica um gráfico que lista seus telefones e os mapeia para números Unicode.

Alguns telefones no alfabeto IPA têm as mesmas representações que as letras no alfabeto latino. Nesses casos, é possível digitar o caractere latino e ter a representação adequada para um telefone. Como os caracteres latinos comumente usados no texto podem representar vários telefones do conjunto de telefones IPA, simplesmente digitar o caractere latino pode não resultar no telefone IPA preciso desejado. Outros telefones do alfabeto IPA precisam ser representados no código como referências de caracteres que consistem em um e comercial (&), o sinal numérico (#) e um número Unicode para o telefone desejado em hexadecimal ou decimal, todos seguidos por um ponto e vírgula (;). Por exemplo, um schwa (ə) seria representado por &#x0259;.

Para adicionar pronúncias novas ou personalizadas para várias palavras, por exemplo, para expressar dialetos regionais ou para adicionar nomes ou vocabulários adequados específicos a uma disciplina educacional ou médica, crie um léxico e adicione-o SpeechSynthesizer ao uso AddLexiconde .

Aplica-se a

Confira também