Amazon Polly 示例 - AWS SDK for JavaScript

AWS SDK for JavaScript V3 API 参考指南详细描述了 AWS SDK for JavaScript 版本 3 (V3) 的所有API操作。

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

Amazon Polly 示例

JavaScript code example that applies to Node.js execution

此 Node.js 代码示例演示:

  • 将使用 Amazon Polly 录制的音频上传到 Amazon S3

情景

在此示例中,将使用一系列 Node.js 模块,通过 Amazon S3 客户端类的以下方法将使用 Amazon Polly 录制的音频自动上传到 Amazon S3:

先决条件任务

要设置和运行此示例,您必须先完成以下任务:

注意

此示例使用 Amazon Cognito,但是如果您不使用 Amazon Cognito,则 AWS 您的用户必须具有以下权限策略 IAM

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "mobileanalytics:PutEvents", "cognito-sync:*" ], "Resource": "*", "Effect": "Allow" }, { "Action": "polly:SynthesizeSpeech", "Resource": "*", "Effect": "Allow" } ] }

使用创建 AWS 资源 AWS CloudFormation

AWS CloudFormation 使您能够以可预测的方式重复创建和配置 AWS 基础架构部署。有关的更多信息 AWS CloudFormation,请参阅《AWS CloudFormation 用户指南》

要创建 AWS CloudFormation 堆栈,请执行以下操作:

  1. 按照《 AWS CLI AWS CLI 用户指南》中的说明进行安装和配置。

  2. 在项目文件夹的根目录setup.yaml中创建一个名为的文件,然后将此处的内容复制 GitHub到该文件中。

    注意

    该 AWS CloudFormation 模板是使用此处 AWS CDK 提供的模板生成的 GitHub。有关更多信息 AWS CDK,请参阅《AWS Cloud Development Kit (AWS CDK) 开发人员指南》

  3. 从命令行运行以下命令,替换 STACK_NAME 为堆栈使用唯一的名称。

    重要

    堆栈名称在 AWS 区域和 AWS 账户中必须是唯一的。您最多可指定 128 个字符,支持数字和连字符。

    aws cloudformation create-stack --stack-name STACK_NAME --template-body file://setup.yaml --capabilities CAPABILITY_IAM

    有关 create-stack 命令参数的更多信息,请参阅 AWS CLI 命令参考指南AWS CloudFormation 用户指南

  4. 导航到 AWS CloudFormation 管理控制台,选择堆栈,选择堆栈名称,然后选择资源选项卡以查看已创建资源的列表。

    AWS CloudFormation 资源

将使用 Amazon Polly 录制的音频上传到 Amazon S3

创建文件名为 polly_synthesize_to_s3.js 的 Node.js 模块。确保按照前面SDK所示进行配置,包括安装所需的客户端和软件包。在代码中输入 REGION,还有 BUCKET_NAME。 要访问 Amazon Polly,请创建一个Polly客户服务对象。Replace(替换) "IDENTITY_POOL_ID" 使用您为此示例创建IdentityPoolId的 Amazon Cognito 身份池示例页面中的内容。这也被传递给每个客户端对象。

调用 Amazon Polly 客户端服务对象的 StartSpeechSynthesisCommand 方法以合成语音消息,将其上传到 Amazon S3 存储桶。

import { StartSpeechSynthesisTaskCommand } from "@aws-sdk/client-polly"; import { pollyClient } from "./libs/pollyClient.js"; // Create the parameters const params = { OutputFormat: "mp3", OutputS3BucketName: "videoanalyzerbucket", Text: "Hello David, How are you?", TextType: "text", VoiceId: "Joanna", SampleRate: "22050", }; const run = async () => { try { await pollyClient.send(new StartSpeechSynthesisTaskCommand(params)); console.log(`Success, audio file added to ${params.OutputS3BucketName}`); } catch (err) { console.log("Error putting object", err); } }; run();

可以在此处找到此示例代码 GitHub。