AWS SDK for JavaScript V3 API 参考指南详细描述了 AWS SDK for JavaScript 版本 3 (V3) 的所有API操作。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon Transcribe 示例
在此示例中,使用一系列 Node.js 模块通过 TranscribeService
客户端类的以下方法创建、列出和删除转录作业:
有关 Amazon Transcribe 的更多信息,请参阅 Amazon Transcribe 开发人员指南。
先决条件任务
要设置和运行此示例,您必须先完成以下任务:
-
设置项目环境以运行这些 Node TypeScript 示例,并安装所需的模块 AWS SDK for JavaScript 和第三方模块。按照上的说明进行操作 GitHub
。 -
使用用户凭证创建共享配置文件。有关提供共享凭据文件的更多信息,请参阅和工具参考指南中的共享配置AWS SDKs和凭据文件。
重要
这些示例演示如何使用 ECMAScript6 () ES6 导入/导出客户端服务对象和命令。
这需要使用 Node.js 版本 13.x 或更高版本。要下载并安装最新版本的 Node.js,请参阅 Node.js 下载
。 如果您更喜欢使用 CommonJS 语法,请参阅 JavaScript ES6/CommonJS 语法
启动 Amazon Transcribe 作业
此示例演示如何使用 AWS SDK for JavaScript启动 Amazon Transcribe 转录作业。有关更多信息,请参阅StartTranscriptionJobCommand。
创建一个 libs
目录,然后使用文件名 transcribeClient.js
创建一个 Node.js 模块。将以下代码复制并粘贴到其中,这将创建 Amazon Transcribe 客户端对象。Replace(替换) REGION
与您所在 AWS 的地区。
import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon Transcribe service client object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient };
可以在此处找到此
创建文件名为 transcribe-create-job.js
的 Node.js 模块。确保按照前面SDK所示进行配置,包括安装所需的客户端和软件包。创建一个参数对象,指定所需的参数。使用 StartMedicalTranscriptionJobCommand
命令启动作业。
注意
Replace(替换) MEDICAL_JOB_NAME
并附上转录作业的名称。对于 OUTPUT_BUCKET_NAME
指定保存输出的 Amazon S3 存储桶。对于 JOB_TYPE
指定作业类型。对于 SOURCE_LOCATION
指定源文件的位置。对于 SOURCE_FILE_LOCATION
指定输入媒体文件的位置。
// Import the required AWS SDK clients and commands for Node.js import { StartTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { TranscriptionJobName: "JOB_NAME", LanguageCode: "LANGUAGE_CODE", // For example, 'en-US' MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav' Media: { MediaFileUri: "SOURCE_LOCATION", // For example, "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav" }, OutputBucketName: "OUTPUT_BUCKET_NAME", }; export const run = async () => { try { const data = await transcribeClient.send( new StartTranscriptionJobCommand(params), ); console.log("Success - put", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run();
要运行示例,请在命令提示符中键入以下内容。
node transcribe-create-job.js
可以在此处找到此
列出 Amazon Transcribe 作业
此示例演示如何使用 AWS SDK for JavaScript列出 Amazon Transcribe 转录作业。有关您可以修改的其他设置的更多信息,请参阅 ListTranscriptionJobCommand
。
创建一个 libs
目录,然后使用文件名 transcribeClient.js
创建一个 Node.js 模块。将以下代码复制并粘贴到其中,这将创建 Amazon Transcribe 客户端对象。Replace(替换) REGION
与您所在 AWS 的地区。
import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon Transcribe service client object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient };
可以在此处找到此
创建文件名为 transcribe-list-jobs.js
的 Node.js 模块。确保按照前面SDK所示进行配置,包括安装所需的客户端和软件包。使用所需参数创建参数对象。
注意
Replace(替换) KEY_WORD
使用返回的任务名称必须包含的关键字。
// Import the required AWS SDK clients and commands for Node.js import { ListTranscriptionJobsCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { JobNameContains: "KEYWORD", // Not required. Returns only transcription // job names containing this string }; export const run = async () => { try { const data = await transcribeClient.send( new ListTranscriptionJobsCommand(params), ); console.log("Success", data.TranscriptionJobSummaries); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run();
要运行示例,请在命令提示符中键入以下内容。
node transcribe-list-jobs.js
可以在此处找到此
删除 Amazon Transcribe 作业
此示例演示如何使用 AWS SDK for JavaScript删除 Amazon Transcribe 转录作业。有关选项的更多信息,请参阅 DeleteTranscriptionJobCommand
。
创建一个 libs
目录,然后使用文件名 transcribeClient.js
创建一个 Node.js 模块。将以下代码复制并粘贴到其中,这将创建 Amazon Transcribe 客户端对象。Replace(替换) REGION
与您所在 AWS 的地区。
import { TranscribeClient } from "@aws-sdk/client-transcribe"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Transcribe service object. const transcribeClient = new TranscribeClient({ region: REGION }); export { transcribeClient };
可以在此处找到此
创建文件名为 transcribe-delete-job.js
的 Node.js 模块。确保按照前面SDK所示进行配置,包括安装所需的客户端和软件包。指定 AWS 区域以及要删除的任务的名称。
注意
Replace(替换) JOB_NAME
并附上要删除的作业的名称。
// Import the required AWS SDK clients and commands for Node.js import { DeleteTranscriptionJobCommand } from "@aws-sdk/client-transcribe"; import { transcribeClient } from "./libs/transcribeClient.js"; // Set the parameters export const params = { TranscriptionJobName: "JOB_NAME", // Required. For example, 'transciption_demo' }; export const run = async () => { try { const data = await transcribeClient.send( new DeleteTranscriptionJobCommand(params), ); console.log("Success - deleted"); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run();
要运行示例,请在命令提示符中键入以下内容。
node transcribe-delete-job.js
可以在此处找到此