Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Caricamento di un lessico
<a name="managing-lexicons-console-upload"></a>

I lessici utilizzati devono essere conformi alla raccomandazione del W3C della Pronunciation Lexicon Specification (PLS). Per ulteriori informazioni, consulta [Pronunciation Lexicon Specification (PLS) Version 1.0](https://www.w3.org/TR/pronunciation-lexicon/#S4.7) sul sito Web di W3C.

------
#### [ Console - Lexicons tab ]

Per usare un lessico di pronuncia, è necessario prima caricarlo. Nella console è possibile caricare un lessico sia dalla scheda **Text-to-Speech** (Sintesi vocale) che dalla scheda **Lexicons** (Lessici).

Le procedure riportate di seguito mostrano come aggiungere lessici che è possibile utilizzare per personalizzare il modo in cui vengono pronunciate parole e frasi non comuni per la lingua scelta. <a name="upload-lexicon-lexicons-tab"></a>

**Per aggiungere un lessico dalla scheda Lexicons (Lessici)**

1. Accedi a Console di gestione AWS e apri la console Amazon Polly all'indirizzo. [https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)

1. Scegli la scheda **Lexicons** (Lessici).

1. Scegli **Upload lexicon** (Carica lessico).

1. Fornisci un nome per il lessico e quindi utilizza **Choose a lexicon** (Scegli un lessico) per individuare il lessico da caricare. È possibile caricare solo file PLS con estensione.pls o .xml.

1. Scegli **Upload lexicon** (Carica lessico). Se esiste già un lessico con lo stesso nome (indipendentemente dall'estensione .pls o .xml), il caricamento del lessico sovrascrive il lessico esistente.

------
#### [ Console - TTS tab ]<a name="upload-lexicon-tts-tab"></a>

**Per aggiungere un lessico dalla scheda text-to-Speech**

1. Accedi a Console di gestione AWS e apri la console Amazon Polly all'indirizzo. [https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)

1. Scegli la scheda **Text-to-Speech** (Sintesi vocale).

1. Espandi **Additional settings** (Impostazioni aggiuntive), attiva **Customize pronunciation** (Personalizza la pronuncia), scegli **Upload lexicon** (Carica lessico).

1. Fornisci un nome per il lessico e quindi utilizza **Choose a lexicon** (Scegli un lessico) per individuare il lessico da caricare. Puoi usare solo i file PLS che utilizzano estensioni .pls e .xml. 

1. Scegli **Upload lexicon** (Carica lessico). Se esiste già un lessico con lo stesso nome (indipendentemente dall'estensione .pls o .xml), il caricamento del lessico sovrascrive il lessico esistente.

------
#### [ AWS CLI - one lexeme ]

Con Amazon Polly, puoi utilizzare [PutLexicon](API_PutLexicon.md) per memorizzare i lessici di pronuncia in una AWS regione specifica per il tuo account. Quindi, puoi specificare uno o più di questi lessici archiviati nella richiesta [SynthesizeSpeech](API_SynthesizeSpeech.md) da applicare prima che il servizio avvii la sintesi del testo. Per ulteriori informazioni, consulta [Gestione dei lessici](managing-lexicons.md).

Considera il seguente lessico conforme allo standard PLS W3C. 

```
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0" 
      xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon 
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
      alphabet="ipa" 
      xml:lang="en-US">
  <lexeme>
    <grapheme>W3C</grapheme>
    <alias>World Wide Web Consortium</alias>
  </lexeme>
</lexicon>
```

Tieni presente quanto segue:
+ I due attributi specificati nell'elemento `<lexicon>`:
  + L'attributo `xml:lang` specifica il codice della lingua, `en-US`, a cui si applica il lessico. Amazon Polly può utilizzare questo lessico di esempio se la voce specificata nella chiamata `SynthesizeSpeech` ha lo stesso codice della lingua (it-IT). 
**Nota**  
Puoi utilizzare l'operazione `DescribeVoices` per trovare il codice della lingua associato a una voce.

     
  + L'attributo `alphabet` specifica `IPA`, a indicare che per le pronunce viene utilizzato l'alfabeto fonetico internazionale (IPA, International Phonetic Alphabet). L'IPA è uno degli alfabeti utilizzati per scrivere le pronunce. Amazon Polly supporta anche l'alfabeto X-SAMPA (Extended Speech Assessment Methods Phonetic Alphabet).

     
+ L'elemento `<lexeme>` descrive la mappatura tra `<grapheme>` (ovvero una rappresentazione testuale della parola) e `<alias>`. 

Per testare questo lessico, procedi come indicato di seguito.

1. Salva il lessico con il nome `example.pls`.

1. Esegui il `put-lexicon` AWS CLI comando per memorizzare il lessico (con il nome`w3c`), nella regione us-east-2.

   ```
   aws polly put-lexicon \
   --name w3c \
   --content file://example.pls
   ```

1. Esegui il comando `synthesize-speech` per sintetizzare il testo di esempio in un flusso audio (`speech.mp3`) e specifica il parametro opzionale `lexicon-name`. 

   ```
   aws polly synthesize-speech \
   --text 'W3C is a Consortium' \
   --voice-id Joanna \
   --output-format mp3 \
   --lexicon-names="w3c" \
   speech.mp3
   ```

1. Riproduci il file `speech.mp3` risultante e nota che la parola W3C nel testo è sostituita da World Wide Web Consortium.

Il lessico di esempio precedente utilizza un alias. L'alfabeto IPA menzionato nel lessico non viene utilizzato. Il lessico seguente specifica una pronuncia fonetica utilizzando l'elemento `<phoneme>` con l'alfabeto IPA.

```
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0" 
      xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon 
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
      alphabet="ipa" 
      xml:lang="en-US">
  <lexeme>
    <grapheme>pecan</grapheme>
    <phoneme>pɪˈkɑːn</phoneme>
  </lexeme>
</lexicon>
```

Segui la stessa procedura per testare questo lessico. Assicurati di specificare un testo di input che contenga la parola «pecan» (ad esempio, «Pecan pie is delicious»).

Consulta le seguenti risorse per esempi di codice aggiuntivi per il funzionamento dell' PutLexicon API:
+ Esempio di Java: [PutLexicon](PutLexiconSample.md)
+ Esempio di Python (Boto3): [PutLexicon](PutLexiconSamplePython.md)

------
#### [ AWS CLI - multiple lexemes ]

Con Amazon Polly, puoi utilizzare [PutLexicon](API_PutLexicon.md) per memorizzare i lessici di pronuncia in una AWS regione specifica per il tuo account. Quindi, puoi specificare uno o più di questi lessici archiviati nella richiesta [SynthesizeSpeech](API_SynthesizeSpeech.md) da applicare prima che il servizio avvii la sintesi del testo. Per ulteriori informazioni, consulta [Gestione dei lessici](managing-lexicons.md).

In questo esempio il lessema specificato nel lessico si applica esclusivamente al testo di input per la sintesi. Considera il lessico seguente: 

```
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0"
      xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
      alphabet="ipa" xml:lang="en-US">

  <lexeme> 
    <grapheme>W3C</grapheme>
    <alias>World Wide Web Consortium</alias>
  </lexeme>
  <lexeme> 
    <grapheme>W3C</grapheme>
    <alias>WWW Consortium</alias>
  </lexeme>
  <lexeme> 
    <grapheme>Consortium</grapheme>
    <alias>Community</alias>
  </lexeme>
</lexicon>
```

Il lessico specifica tre lessemi, due dei quali definiscono un alias per il grafema W3C come indicato di seguito:
+ Il primo elemento `<lexeme`> definisce un alias (World Wide Web Consortium).
+ Il secondo elemento `<lexeme>` definisce un alias alternativo (WWW Consortium). 

Amazon Polly utilizza la prima sostituzione per ogni grafema in un lessico.

Il terzo elemento `<lexeme>` definisce un sostituto (Community) per la parola Consortium.

In primo luogo, è opportuno testare questo lessico. Supponi di voler sintetizzare il seguente testo di esempio per un file audio (`speech.mp3`) e di specificare il lessico in una chiamata a `SynthesizeSpeech`.

```
The W3C is a Consortium
```

In primo luogo `SynthesizeSpeech` applica il lessico come segue: 
+ Come per il primo lessema, la parola W3C viene sostituita da World Wide Web Consortium. Il testo rivisto viene visualizzato come segue:

  ```
  The World Wide Web Consortium is a Consortium
  ```
+ L'alias definito nel terzo lessema si applica solo alla parola Consortium che era parte del testo originale, generando il testo seguente:

  ```
  The World Wide Web Consortium is a Community.
  ```

Puoi verificarlo utilizzando AWS CLI quanto segue:

1. Salva il lessico con il nome `example.pls`.

1. Esegui il comando `put-lexicon` per archiviare il lessico con il nome w3c nella regione us-east-2.

   ```
   aws polly put-lexicon \
   --name w3c \
   --content file://example.pls
   ```

1. Esegui il comando `list-lexicons` per verificare che il lessico w3c sia incluso nell'elenco dei lessici restituito.

   ```
   aws polly list-lexicons
   ```

1. Esegui il comando `synthesize-speech` per sintetizzare il testo di esempio in un file audio (`speech.mp3`) e specifica il parametro opzionale `lexicon-name`. 

   ```
   aws polly synthesize-speech \
   --text 'W3C is a Consortium' \
   --voice-id Joanna \
   --output-format mp3 \
   --lexicon-names="w3c" \
   speech.mp3
   ```

1. Riproduci il file `speech.mp3` risultante per verificare che la sintesi vocale rifletta le modifiche al testo.

Consulta le seguenti risorse per esempi di codice aggiuntivi per il funzionamento dell' PutLexicon API:
+ Esempio di Java: [PutLexicon](PutLexiconSample.md)
+ Esempio di Python (Boto3): [PutLexicon](PutLexiconSamplePython.md)

------