使用 的 Amazon Polly 範例 AWS CLI - AWS SDK 程式碼範例
動作

文件 AWS SDK AWS 範例 SDK 儲存庫中有更多可用的 GitHub 範例。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 的 Amazon Polly 範例 AWS CLI

下列程式碼範例示範如何搭配 Amazon Polly AWS Command Line Interface 使用 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會示範如何呼叫個別服務函數，但您可以在相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 delete-lexicon。

AWS CLI

刪除詞庫

下列delete-lexicon範例會刪除指定的詞庫。

aws polly delete-lexicon \
    --name w3c

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Polly 開發人員指南中的使用 DeleteLexicon 操作。

  • 如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 DeleteLexicon。

下列程式碼範例示範如何使用 get-lexicon。

AWS CLI

擷取詞庫的內容

下列get-lexicon範例會擷取指定發音詞庫的內容。

aws polly get-lexicon \
    --name w3c

輸出：

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

如需詳細資訊，請參閱 Amazon Polly 開發人員指南中的使用 GetLexicon 操作。

  • 如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 GetLexicon。

下列程式碼範例示範如何使用 get-speech-synthesis-task。

AWS CLI

取得語音合成任務的相關資訊

下列get-speech-synthesis-task範例會擷取指定語音合成任務的相關資訊。

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

輸出：

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

如需詳細資訊，請參閱 Amazon Polly 開發人員指南中的建立長音訊檔案。

下列程式碼範例示範如何使用 list-lexicons。

AWS CLI

列出您的詞庫

下列list-lexicons範例列出您的發音詞。

aws polly list-lexicons

輸出：

{
    "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
            }
        }
    ]
}

如需詳細資訊，請參閱 Amazon Polly 開發人員指南中的使用 ListLexicons 操作。

  • 如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 ListLexicons。

下列程式碼範例示範如何使用 list-speech-synthesis-tasks。

AWS CLI

列出您的語音合成任務

下列list-speech-synthesis-tasks範例列出您的語音合成任務。

aws polly list-speech-synthesis-tasks

輸出：

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

如需詳細資訊，請參閱 Amazon Polly 開發人員指南中的建立長音訊檔案。

下列程式碼範例示範如何使用 put-lexicon。

AWS CLI

儲存詞庫

下列put-lexicon範例會存放指定的發音詞。example.pls 檔案會指定 W3C PLS 相容詞庫。

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

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

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Polly 開發人員指南中的使用 PutLexicon 操作。

  • 如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 PutLexicon。

下列程式碼範例示範如何使用 start-speech-synthesis-task。

AWS CLI

若要合成文字

下列start-speech-synthesis-task範例會在 中合成文字，text_file.txt並將產生的 MP3 檔案存放在指定的儲存貯體中。

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

輸出：

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

如需詳細資訊，請參閱 Amazon Polly 開發人員指南中的建立長音訊檔案。