PromptBuilder.AppendTextWithPronunciation(String, String) Méthode

Définition

Ajoute du texte à l'objet PromptBuilder et spécifie la prononciation du texte.

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)

Paramètres

textToSpeak
String

Chaîne contenant la forme écrite du mot dans l'alphabet classique pour une langue.

pronunciation
String

Chaîne contenant des phonèmes à utiliser en suivant l'alphabet phonétique international (IPA).

Exemples

L’exemple suivant initialise une nouvelle instance de la PromptBuilder classe. Il ajoute ensuite la chaîne de texte « Mon nom est » au instance. Enfin, il ajoute une chaîne contenant le nom propre « DuBois » et spécifie la prononciation du nom.

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

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

Le balisage suivant montre le SSML généré par cet PromptBuilder objet.

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

Remarques

Le synthétiseur parle le contenu du pronunciation paramètre, pas le contenu du textToSpeak paramètre.

Les prononciations spécifiées dans les invites s’appliquent uniquement à l’occurrence individuelle d’un mot et remplacent les prononciations du moteur vocal ou de l’une de ses lexiques actuellement actives. En règle générale, vous utiliserez des prononciations inline pour les prononciations personnalisées de mots existants ou pour la prononciation de mots rares, tels que les noms propres, que le moteur de synthèse vocale peut ne pas prononcer aussi bien que prévu.

Les prononciations inline doivent être spécifiées à l’aide de téléphones de l’alphabet phonétique international (IPA). Un téléphone est une lettre ou un caractère qui représente un son discret de la parole. Les moteurs vocaux conformes à la spécification SSML (Speech Synthesis Markup Language) version 1.0 prononceront les téléphones à partir de l’IPA. Pour spécifier des prononciations inline à l’aide d’autres alphabets phonétiques, consultez AppendSsmlMarkup.

L’IPA publie un graphique qui répertorie ses téléphones et les mappe aux nombres Unicode.

Certains téléphones de l’alphabet IPA ont les mêmes représentations que les lettres de l’alphabet latin. Dans ce cas, il est possible de taper le caractère latin et d’avoir la représentation appropriée pour un téléphone. Étant donné que les caractères latins couramment utilisés dans le texte peuvent représenter plusieurs téléphones de l’ensemble de téléphones IPA, le simple fait de taper le caractère latin peut ne pas entraîner le téléphone IPA précis souhaité. Les autres téléphones de l’alphabet IPA doivent être représentés dans le code sous forme de références de caractères composées d’un esperluette (&), du signe numérique (#) et d’un numéro Unicode pour le téléphone souhaité en hexadécimal ou décimal, le tout suivi d’un point-virgule (;). Par exemple, un schwa (ə) est représenté par &#x0259;.

Pour ajouter des prononciations nouvelles ou personnalisées pour plusieurs mots, par exemple pour exprimer des dialectes régionaux ou pour ajouter des noms propres ou un vocabulaire propre à une discipline éducative ou médicale, créez un lexique et ajoutez-le à l’aide AddLexiconde SpeechSynthesizer .

S’applique à

Voir aussi