Contrôler la façon dont des types particuliers de mots sont prononcés

<say-as>

La <say-as> balise est prise en charge par des moteurs TTS génératifs, longs, neuronaux et standard. Notez toutefois que si Amazon Polly utilise une voix neuronale et rencontre la <say-as> balise avec l'charactersoption lors de l'exécution, la phrase affectée sera synthétisée à l'aide de la voix standard correspondante. Cependant, la phrase affectée sera toujours facturée comme si elle utilisait une voix neuronale.

Utilisez la <say-as> balise associée à l'interpret-asattribut pour indiquer à Amazon Polly comment prononcer certains caractères, mots et chiffres. Cela vous permet de fournir un contexte supplémentaire afin d'éliminer toute ambiguïté quant à la manière dont Amazon Polly doit afficher le texte.

La <say-as> balise utilise un attributinterpret-as, qui utilise un certain nombre de valeurs disponibles possibles. Chacune d'elles utilise la même syntaxe :

<say-as interpret-as="value">[text to be interpreted]</say-as>

Les valeurs suivantes sont disponibles avec interpret-as :

• charactersou spell-out : épelle chaque lettre du texte, comme dans a-b-c.

  Note

  Cette option n'est actuellement pas prise en charge pour les voix neuronales. Si vous utilisez une voix neuronale et que ce code SSML est détecté par Amazon Polly au moment de l'exécution, la phrase affectée sera synthétisée à l'aide de la voix standard correspondante. Notez toutefois que cette phrase sera toujours facturée comme si elle utilisait une voix neuronale.

• cardinal ou number : interprète le texte numérique comme nombre cardinal, par exemple 1 234.

• ordinal : interprète le texte numérique comme nombre ordinal, par exemple 1 234ème.

• digits : énonce chaque chiffre séparément, par exemple 1-2-3-4.

• fraction : interprète le texte numérique comme une fraction. Cela fonctionne aussi bien pour les fractions courantes comme 3/20 que pour les fractions mixtes comme 2 ½. Voir ci-dessous pour plus d'informations.

• unit : interprète un texte numérique comme une mesure. Cette valeur doit être suivie d'un nombre ou d'une fraction, puis d'une unité, sans espace intermédiaire comme dans 1/2inch, ou simplement d'une unité, comme dans 1meter.

• date : interprète le texte comme une date. Le format de la date doit être spécifié avec l'attribut de format. Voir ci-dessous pour plus d'informations.

• time : interprète le texte numérique comme une durée, en minutes et secondes, comme dans 1'21".

• address : interprète le texte comme une partie d'une adresse postale.

• expletive : signale que le contenu inclus dans la balise doit être exclu.

• telephone : interprète le texte numérique comme un numéro de téléphone à 7 ou 10 chiffres, comme dans 2025551212. Vous pouvez également utiliser cette valeur pour traiter les numéros de poste téléphonique, comme dans 2025551212x345. Voir ci-dessous pour plus d'informations.

  Note

  Actuellement, l'option telephone n'est pas disponible pour toutes les langues. Cependant, il est disponible pour les voix parlant des variantes de langue anglaise (en-AU, en-GB, en-IN, en-US et), des variantes linguistiques espagnoles (es-ES, es-MX et es-US en-GB-WLS), des variantes linguistiques françaises (fr-FR et fr-CA) et des variantes portugaises (pt-BR et pt-PT), ainsi que pour l'allemand (de-DE), l'italien (it-IT), le japonais (ja-JP) et le russe (Ru-JP) RU). Il convient également de noter que dans certains cas, des langues telles que l'arabe (arb) traitent automatiquement le numéro défini comme un numéro de téléphone et n'implémentent donc pas réellement la balise telephone SSML.

Fractions

Amazon Polly interprète les valeurs de la say-as balise dotées de l'interpret-as="fraction"attribut comme des fractions communes. La syntaxe suivante est utilisée pour les fractions :

• Fraction

  Syntaxe :cardinal number/cardinal number, telle que 2/9.

  Ainsi, <say-as interpret-as="fraction">2/9</say-as> est prononcé « deux neuvièmes ».

• Nombre mixte non négatif

  Syntaxe : cardinal number +cardinal number/cardinal number, telle que 3+1/2.

  Ainsi, <say-as interpret-as="fraction">3+1/2</say-as> est prononcé « trois et demi ».

  Note

  Il doit y avoir un + écart entre le « 3 » et le « 1/2 ». Amazon Polly ne prend pas en charge un nombre mixte sans le+, tel que « 3 1/2 ».

Dates

Lorsque interpret-as a la valeur date, vous devez aussi indiquer le format de la date.

Cette balise utilise la syntaxe suivante :

<say-as interpret-as="date" format="format">[date]</say-as>

Par exemple :

<speak>
     I was born on <say-as interpret-as="date" format="mdy">12-31-1900</say-as>.
</speak>

Les formats suivants peuvent être utilisés avec l'attribut date.

• mdy: Month-day-year.

• dmy: Day-month-year.

• ymd: Year-month-day.

• md : mois-jour.

• dm : jour-mois.

• ym : année-mois.

• my : mois-année.

• d: jour.

• m: mois.

• y: Année.

• yyyymmdd: Year-month-day. Si vous utilisez ce format, vous pouvez faire en sorte qu'Amazon Polly ignore certaines parties de la date à l'aide de points d'interrogation.

  Par exemple, Amazon Polly affiche ce qui suit comme « 22 septembre » :

  <say-as interpret-as="date">????0922</say-as>

  Format n'est pas nécessaire.

Téléphone

Amazon Polly essaie d'interpréter correctement le texte que vous fournissez en fonction de sa mise en forme, même sans le <say-as> tag. Par exemple, si votre texte inclut « 202-555-1212 », Amazon Polly l'interprète comme un numéro de téléphone à 10 chiffres et indique chaque chiffre individuellement, avec une courte pause pour chaque tiret. Dans ce cas, il n'est pas nécessaire d'utiliser <say-as interpret-as="telephone">. Toutefois, si vous fournissez le texte « 2025551212 » et que vous souhaitez qu'Amazon Polly le prononce sous forme de numéro de téléphone, vous devez le spécifier. <say-as interpret-as="telephone">

La logique d'interprétation de chaque élément est propre à la langue. Par exemple, les numéros de téléphone ne se prononcent pas de la même façon en anglais américain et en anglais britannique (en anglais britannique, les chiffres identiques qui se suivent sont regroupés, comme dans « double five » ou « triple four »). Pour voir la différence, testez l'exemple suivant avec une voix américaine et une voix britannique :

<speak>
     Richard's number is <say-as interpret-as="telephone">2122241555</say-as>
</speak>