使用 Amazon Polly 的示例 Amazon CLI - Amazon Command Line Interface
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Amazon Polly 的示例 Amazon CLI

以下代码示例向您展示了如何在 Amazon Polly 中使用来执行操作和实现常见场景。 Amazon Command Line Interface

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景和跨服务示例的上下文查看操作。

场景是展示如何通过在同一服务中调用多个函数来完成特定任务任务的代码示例。

每个示例都包含一个指向的链接 GitHub，您可以在其中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示如何使用 delete-lexicon。

Amazon CLI

删除词典

以下 delete-lexicon 示例将删除指定的词典。

aws polly delete-lexicon \
    --name w3c

此命令不生成任何输出。

有关更多信息，请参阅 Amazon Polly 开发者指南中的使用 DeleteLexicon 操作。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DeleteLexicon中的。

以下代码示例演示如何使用 get-lexicon。

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考GetLexicon中的。

以下代码示例演示如何使用 get-speech-synthesis-task。

Amazon 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。

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考ListLexicons中的。

以下代码示例演示如何使用 list-speech-synthesis-tasks。

Amazon 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。

Amazon 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 的详细信息，请参阅Amazon CLI 命令参考PutLexicon中的。

以下代码示例演示如何使用 start-speech-synthesis-task。

Amazon 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 开发人员指南》中的创建长音频文件。