Partilhar via


PromptBuilder.AppendTextWithPronunciation(String, String) Método

Definição

Acrescenta o PromptBuilder texto ao objeto 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 uma linguagem.

pronunciation
String

Uma cadeia de caracteres que contém telefones a serem falados do Alfabeto Fonético Internacional (IPA).

Exemplos

O exemplo a seguir inicializa uma nova instância da PromptBuilder classe. Em seguida, acrescenta a cadeia de caracteres 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 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 (Speech Synthesis Markup Language) versão 1.0 pronunciarão telefones do IPA. Para especificar pronúncias embutidas usando outros alfabetos fonéticos, consulte AppendSsmlMarkup.

A 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 normalmente usados em 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 caractere que consistem em um e comercial (>), o sinal de número (#) 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, expressar dialetos regionais ou 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 AddLexicon.

Aplica-se a

Confira também