步骤 2.2：使用 Amazon CLI 进行入门练习 - Amazon Polly
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

步骤 2.2：使用 Amazon CLI 进行入门练习

现在，您可以测试 Amazon Polly 提供的语音合成。在本练习中，您通过传入示例文本调用 SynthesizeSpeech 操作。您可以将生成的音频保存为文件并验证其内容。

  1. 运行 synthesize-speech Amazon CLI 命令以将示例文本合成为音频文件 (hello.mp3)。

    以下 Amazon CLI 示例针对 Linux、Unix 和 macOS 编排了格式。对于 Windows，请将每行末尾的反斜杠 (\) Unix 行继续符替换为脱字号 (^) 并在输入文本周围使用全角引号（“），内部标签使用单引号（’）。

    aws polly synthesize-speech \
    --output-format mp3 \
    --voice-id Joanna \
    --text 'Hello, my name is Joanna. I learned about the W3C on 10/3 of last year.' \
    hello.mp3

    在调用 synthesize-speech 时，您需要提供合成用示例文本、要使用的语音（通过提供语音 ID，如以下步骤 3 中所述）和输出格式。该命令会将生成的音频保存为 hello.mp3 文件。

    除了 MP3 文件，此操作还可将以下输出发送至控制台。

    {
        "ContentType": "audio/mpeg", 
        "RequestCharacters": "71"
}

  2. 播放生成的 hello.mp3 文件以验证合成的语音。

  3. 使用 DescribeVoices 操作获取可用的语音列表。运行以下 describe-voices Amazon CLI 命令。

    aws polly describe-voices

    作为响应，Amazon Polly 会返回所有可用语音的列表。对于每个语音，响应提供以下元数据：语音 ID、语言代码、语言名称和语音性别。以下为示例响应。

    {
    "Voices": [
        {
            "Gender": "Female",
            "Name": "Salli",
            "LanguageName": "US English",
            "Id": "Salli",
            "LanguageCode": "en-US",
            "SupportedEngines": [
                "neural",
                "standard"
            ]
        },
        {
            "Gender": "Female",
            "Name": "Danielle",
            "LanguageName": "US English",
            "Id": "Danielle",
            "LanguageCode": "en-US",
            "SupportedEngines": [
                "long-form"
            ]
        }
    ]
}

    作为一种选项，您可以指定语言代码，以查找特定语言的可用语音。Amazon Polly 支持数十种语音。以下示例列出了所有巴西葡萄牙语语音。

    aws polly describe-voices \
    --language-code pt-BR

    有关语言代码的列表，请参阅 Amazon Polly 支持的语言。这些语言代码为 W3C 语言标识标签（ISO 639 语言名称代码的 – ISO 3166 国家/地区代码）。例如，en-US（美国英语）、en-GB（英国英语）和 es-ES（西班牙语）等。

    您也可以使用 Amazon CLI 中的 help 选项来获取语言代码的列表：

    aws polly describe-voices help