View a markdown version of this page

Esempi di utilizzo di Amazon Polly AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

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à.

Esempi di utilizzo di Amazon Polly AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando Amazon Polly. AWS Command Line Interface

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare delete-lexicon.

AWS CLI

Come eliminare un lessico

L’esempio delete-lexicon seguente elimina il lessico specificato.

aws polly delete-lexicon \
    --name w3c

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Using the DeleteLexicon operation nella Amazon Polly Developer Guide.

  • Per i dettagli sulle API, consulta la sezione DeleteLexicon AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-lexicon.

AWS CLI

Come recuperare il contenuto di un lessico

L’esempio get-lexicon seguente recupera il contenuto del lessico di pronuncia specificato.

aws polly get-lexicon \
    --name w3c

Output:

{
    "Lexicon": {
        "Content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<lexicon version=\"1.0\" \n      xmlns=    \"http://www.w3.org/2005/01/pronunciation-lexicon\"\n      xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n          xsi:schemaLocation=\"http://www.w3.org/2005/01/pronunciation-lexicon \n        http://www.w3.org/TR/2007/CR-pronunciation-    lexicon-20071212/pls.xsd\"\n      alphabet=\"ipa\" \n      xml:lang=\"en-US\">\n  <lexeme>\n    <grapheme>W3C</grapheme>\n        <alias>World Wide Web Consortium</alias>\n  </lexeme>\n</lexicon>\n",
        "Name": "w3c"
    },
    "LexiconAttributes": {
        "Alphabet": "ipa",
        "LanguageCode": "en-US",
        "LastModified": 1603908910.99,
        "LexiconArn": "arn:aws:polly:us-west-2:880185128111:lexicon/w3c",
        "LexemesCount": 1,
        "Size": 492
    }
}

Per ulteriori informazioni, consulta Using the GetLexicon operation nella Amazon Polly Developer Guide.

  • Per i dettagli sulle API, consulta la sezione GetLexicon AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-speech-synthesis-task.

AWS CLI

Come ottenere informazioni su un’attività di sintesi vocale

L’esempio get-speech-synthesis-task seguente recupera le informazioni sull’attività di sintesi vocale specificata.

aws polly get-speech-synthesis-task \
    --task-id 70b61c0f-57ce-4715-a247-cae8729dcce9

Output:

{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "completed",
        "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}

Per ulteriori informazioni, consulta Creazione di file audio di grandi dimensioni nella Guida per gli sviluppatori di Amazon Polly.

L’esempio di codice seguente mostra come utilizzare list-lexicons.

AWS CLI

Come elencare i lessici correnti

L’esempio list-lexicons seguente elenca i lessici di pronuncia in uso.

aws polly list-lexicons

Output:

{
    "Lexicons": [
        {
            "Name": "w3c",
            "Attributes": {
                "Alphabet": "ipa",
                "LanguageCode": "en-US",
                "LastModified": 1603908910.99,
                "LexiconArn": "arn:aws:polly:us-east-2:123456789012:lexicon/w3c",
                "LexemesCount": 1,
                "Size": 492
            }
        }
    ]
}

Per ulteriori informazioni, consulta Using the ListLexicons operation nella Amazon Polly Developer Guide.

  • Per i dettagli sulle API, consulta la sezione ListLexicons AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-speech-synthesis-tasks.

AWS CLI

Come elencare le tue attività di sintesi vocale

L’esempio list-speech-synthesis-tasks seguente elenca le attività di sintesi vocale.

aws polly list-speech-synthesis-tasks

Output:

{
    "SynthesisTasks": [
        {
            "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
            "TaskStatus": "completed",
            "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
            "CreationTime": 1603911042.689,
            "RequestCharacters": 1311,
            "OutputFormat": "mp3",
            "TextType": "text",
            "VoiceId": "Joanna"
        }
    ]
}

Per ulteriori informazioni, consulta Creazione di file audio di grandi dimensioni nella Guida per gli sviluppatori di Amazon Polly.

L’esempio di codice seguente mostra come utilizzare put-lexicon.

AWS CLI

Come archiviare un lessico

L’esempio put-lexicon seguente archivia il lessico di pronuncia specificato. Il example.pls file specifica un lessico del W3C. PLS-compliant 

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

Contenuto di example.pls

{
    <?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>
}

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Using the PutLexicon operation nella Amazon Polly Developer Guide.

  • Per i dettagli sulle API, consulta la sezione PutLexicon AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare start-speech-synthesis-task.

AWS CLI

Come sintetizzare il testo

L’esempio start-speech-synthesis-task seguente sintetizza il testo in text_file.txt e memorizza il file MP3 risultante nel bucket specificato.

aws polly start-speech-synthesis-task \
    --output-format mp3 \
    --output-s3-bucket-name amzn-s3-demo-bucket \
    --text  file://text_file.txt \
    --voice-id Joanna

Output:

{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "scheduled",
        "OutputUri": "https://s3.us-east-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}

Per ulteriori informazioni, consulta Creazione di file audio di grandi dimensioni nella Guida per gli sviluppatori di Amazon Polly.