PromptBuilder.AppendTextWithPronunciation(String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic Sub AppendTextWithPronunciation (textToSpeak As String, pronunciation As String)Paramètres
- textToSpeak
- String
Chaîne contenant la forme écrite du mot à l’aide de l’alphabet conventionnel d’une langue.
- pronunciation
- String
Chaîne contenant des téléphones à prononcer à partir de 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 » à l’instance. Enfin, il ajoute une chaîne contenant le nom approprié « 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, et non 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 de parole ou l’une de ses lexicons 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 des noms appropriés, 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 parole. Les moteurs speech 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 numéros Unicode.
Certains téléphones de l’alphabet IPA ont les mêmes représentations que les lettres de l’alphabet latin. Dans ces 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 comme couramment utilisés dans le texte peuvent représenter plusieurs téléphones de l’ensemble de téléphones IPA, la saisie du caractère latin peut ne pas entraîner le téléphone IPA précis souhaité. D’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 ampersand (&), du signe numérique (#) et d’un numéro Unicode pour le téléphone souhaité en hexadécimal ou décimal, suivis d’un point-virgule (;)). Par exemple, un schwa (ə ;) est représenté par ə.
Pour ajouter des prononciations nouvelles ou personnalisées pour plusieurs mots, par exemple pour exprimer des dialectes régionaux ou pour ajouter des noms ou vocabulaires appropriés spécifiques à une discipline éducative ou médicale, créez un lexique et ajoutez-le à l’utilisation SpeechSynthesizerAddLexicon.
