[適用於 JavaScript 的 AWS SDK V3 API 參考指南](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)詳細說明 第 3 版 適用於 JavaScript 的 AWS SDK (V3) 的所有 API 操作。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Transcribe 範例
Amazon Transcribe 可讓開發人員輕鬆地將語音新增至其應用程式的文字功能。
![\[JavaScript 環境、軟體開發套件和 Amazon Transcribe 之間的關係\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/code-samples-transcribe.png)
Amazon Transcribe 的 JavaScript API 透過 [TranscribeService](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/Transcribe/) 用戶端類別公開。
**Topics**
+ [Amazon Transcribe 範例](transcribe-examples-section.md)
+ [Amazon Transcribe 醫療範例](transcribe-medical-examples-section.md)
# Amazon Transcribe 範例
在此範例中，一系列 Node.js 模組用於使用下列`TranscribeService`用戶端類別方法建立、列出和刪除轉錄任務：
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartTranscriptionJobCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/)
如需 Amazon Transcribe 使用者的詳細資訊，請參閱 [Amazon Transcribe 開發人員指南](https://docs.aws.amazon.com//transcribe/latest/dg/what-is-transcribe.html)。
## 先決條件任務
若要設定和執行此範例，您必須先完成這些任務：
+ 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的 適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/README.md) 上的指示。
+ 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。
**重要**
這些範例示範如何使用 ECMAScript6 (ES6) 匯入/匯出用戶端服務物件和命令。
這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download)
如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md)
## 啟動 Amazon Transcribe 任務
此範例示範如何使用 啟動 Amazon Transcribe 轉錄任務 適用於 JavaScript 的 AWS SDK。如需詳細資訊，請參閱 [StartTranscriptionJobCommand](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartTranscriptionJobCommand/)。
建立`libs`目錄，並建立檔案名稱為 的 Node.js 模組`transcribeClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Transcribe 用戶端物件。將 *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 };
```
您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)範例程式碼。
以檔名 `transcribe-create-job.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。建立參數物件，指定必要的參數。使用 `StartMedicalTranscriptionJobCommand`命令啟動任務。
**注意**
將 *MEDICAL\$1JOB\$1NAME* 取代為轉錄任務的名稱。針對 *OUTPUT\$1BUCKET\$1NAME*，指定儲存輸出的 Amazon S3 儲存貯體。針對 *JOB\$1TYPE*，指定任務類型。針對 *SOURCE\$1LOCATION*，指定來源檔案的位置。針對 *SOURCE\$1FILE\$1LOCATION*，指定輸入媒體檔案的位置。
```
// 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
```
您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_create_job.js)找到這個範本程式碼。
## 列出 Amazon Transcribe 任務
此範例示範如何使用 列出 Amazon Transcribe 轉錄任務 適用於 JavaScript 的 AWS SDK。如需您可以修改哪些其他設定的詳細資訊，請參閱 [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/)。
建立`libs`目錄，並建立檔案名稱為 的 Node.js 模組`transcribeClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Transcribe 用戶端物件。將 *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 };
```
您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)範例程式碼。
以檔名 `transcribe-list-jobs.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。使用必要的參數建立參數物件。
**注意**
將 *KEY\$1WORD* 取代為傳回任務名稱必須包含的關鍵字。
```
// 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
```
您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_list_jobs.js)找到這個範本程式碼。
## 刪除 Amazon Transcribe 任務
此範例說明如何使用 刪除 Amazon Transcribe 轉錄任務 適用於 JavaScript 的 AWS SDK。如需選用的詳細資訊，請參閱 [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/)。
建立`libs`目錄，並建立檔案名稱為 的 Node.js 模組`transcribeClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Transcribe 用戶端物件。將 *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 };
```
您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)範例程式碼。
以檔名 `transcribe-delete-job.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。指定 AWS 區域，以及您要刪除的任務名稱。
**注意**
將 *JOB\$1NAME* 取代為要刪除的任務名稱。
```
// 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
```
您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_delete_job.js)找到這個範本程式碼。
# Amazon Transcribe 醫療範例
在此範例中，一系列 Node.js 模組用於使用下列`TranscribeService`用戶端類別方法建立、列出和刪除醫療轉錄任務：
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/)
如需 Amazon Transcribe 使用者的詳細資訊，請參閱 [Amazon Transcribe 開發人員指南](https://docs.aws.amazon.com//transcribe/latest/dg/what-is-transcribe.html)。
## 先決條件任務
若要設定和執行此範例，您必須先完成這些任務：
+ 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的 適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/README.md) 上的指示。
+ 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。
**重要**
這些範例示範如何使用 ECMAScript6 (ES6) 匯入/匯出用戶端服務物件和命令。
這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download)
如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md)
## 啟動 Amazon Transcribe 醫療轉錄任務
此範例示範如何使用 啟動 Amazon Transcribe 醫療轉錄任務 適用於 JavaScript 的 AWS SDK。如需詳細資訊，請參閱 [startMedicalTranscriptionJob](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/)。
建立`libs`目錄，並建立檔案名稱為 的 Node.js 模組`transcribeClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Transcribe 用戶端物件。將 *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 };
```
您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)範例程式碼。
以檔名 `transcribe-create-medical-job.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。建立參數物件，指定必要的參數。使用 `StartMedicalTranscriptionJobCommand`命令啟動醫療任務。
**注意**
將 *MEDICAL\$1JOB\$1NAME* 取代為醫療轉錄任務的名稱。針對 *OUTPUT\$1BUCKET\$1NAME*，指定儲存輸出的 Amazon S3 儲存貯體。針對 *JOB\$1TYPE*，指定任務類型。針對 *SOURCE\$1LOCATION*，指定來源檔案的位置。針對 *SOURCE\$1FILE\$1LOCATION*，指定輸入媒體檔案的位置。
```
// Import the required AWS SDK clients and commands for Node.js
import { StartMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";
// Set the parameters
export const params = {
MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // Required
OutputBucketName: "OUTPUT_BUCKET_NAME", // Required
Specialty: "PRIMARYCARE", // Required. Possible values are 'PRIMARYCARE'
Type: "JOB_TYPE", // Required. Possible values are 'CONVERSATION' and 'DICTATION'
LanguageCode: "LANGUAGE_CODE", // For example, 'en-US'
MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav'
Media: {
MediaFileUri: "SOURCE_FILE_LOCATION",
// The S3 object location of the input media file. The URI must be in the same region
// as the API endpoint that you are calling.For example,
// "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav"
},
};
export const run = async () => {
try {
const data = await transcribeClient.send(
new StartMedicalTranscriptionJobCommand(params),
);
console.log("Success - put", data);
return data; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
若要執行範例，請在命令提示中輸入以下內容。
```
node transcribe-create-medical-job.js
```
您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_create_medical_job.js)找到這個範本程式碼。
## 列出 Amazon Transcribe 醫療任務
此範例說明如何使用 列出 Amazon Transcribe 轉錄任務 適用於 JavaScript 的 AWS SDK。如需詳細資訊，請參閱 [ListTranscriptionMedicalJobsCommand](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListMedicalTranscriptionJobsCommand/)。
建立`libs`目錄，並建立檔案名稱為 的 Node.js 模組`transcribeClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Transcribe 用戶端物件。將 *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 };
```
您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)範例程式碼。
以檔名 `transcribe-list-medical-jobs.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。使用必要的參數建立參數物件，並使用 `ListMedicalTranscriptionJobsCommand`命令列出醫療任務。
**注意**
將 *KEYWORD* 取代為傳回任務名稱必須包含的關鍵字。
```
// Import the required AWS SDK clients and commands for Node.js
import { ListMedicalTranscriptionJobsCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";
// Set the parameters
export const params = {
JobNameContains: "KEYWORD", // Returns only transcription job names containing this string
};
export const run = async () => {
try {
const data = await transcribeClient.send(
new ListMedicalTranscriptionJobsCommand(params),
);
console.log("Success", data.MedicalTranscriptionJobName);
return data; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
若要執行範例，請在命令提示中輸入以下內容。
```
node transcribe-list-medical-jobs.js
```
您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_list_medical_jobs.js)找到這個範本程式碼。
## 刪除 Amazon Transcribe 醫療任務
此範例說明如何使用 刪除 Amazon Transcribe 轉錄任務 適用於 JavaScript 的 AWS SDK。如需選用的詳細資訊，請參閱 [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteMedicalTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteMedicalTranscriptionJobCommand/)。
建立`libs`目錄，並建立檔案名稱為 的 Node.js 模組`transcribeClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Transcribe 用戶端物件。將 *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 };
```
您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js)範例程式碼。
以檔名 `transcribe-delete-job.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。使用必要的參數建立參數物件，並使用 `DeleteMedicalJobCommand`命令刪除醫療任務。
**注意**
將 *JOB\$1NAME* 取代為要刪除的任務名稱。
```
// Import the required AWS SDK clients and commands for Node.js
import { DeleteMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";
// Set the parameters
export const params = {
MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // For example, 'medical_transciption_demo'
};
export const run = async () => {
try {
const data = await transcribeClient.send(
new DeleteMedicalTranscriptionJobCommand(params),
);
console.log("Success - deleted");
return data; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
若要執行範例，請在命令提示中輸入以下內容。
```
node transcribe-delete-medical-job.js
```
您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_delete_medical_job.js)找到這個範本程式碼。