

 Das [AWS SDK für JavaScript V3-API-Referenzhandbuch](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) beschreibt detailliert alle API-Operationen für die AWS SDK für JavaScript Version 3 (V3). 

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Beispiele für Amazon Polly
<a name="polly-examples"></a>

![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v3/developer-guide/images/nodeicon.png)

**Dieses Node.js-Codebeispiel zeigt:**
+ Laden Sie mit Amazon Polly aufgenommene Audiodaten auf Amazon S3 hoch

## Das Szenario
<a name="polly-example-synthesize-to-s3-scenario"></a>

In diesem Beispiel werden eine Reihe von Node.js -Modulen verwendet, um mit Amazon Polly aufgezeichnetes Audio mithilfe der folgenden Methoden der Amazon S3-Clientklasse automatisch auf Amazon S3 hochzuladen:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-polly/Class/StartSpeechSynthesisTaskCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-polly/Class/StartSpeechSynthesisTaskCommand/)

## Erforderliche Aufgaben
<a name="polly-example-synthesize-to-s3-prerequisites"></a>

Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:
+ Richten Sie eine Projektumgebung ein, um JavaScript Node-Beispiele auszuführen, indem Sie den Anweisungen unter folgen [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code/s3/README.md).
+ Erstellen Sie eine freigegebene Konfigurationsdatei mit Ihren Anmeldeinformationen. Weitere Informationen zur Bereitstellung einer Datei mit gemeinsam genutzten Anmeldeinformationen finden Sie unter [Dateien mit gemeinsam genutzten Konfigurationen und Anmeldeinformationen](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) im *AWS SDKs Referenzhandbuch zu Tools*.
+ Erstellen Sie eine AWS Identity and Access Management (IAM) unauthentifizierte Amazon Cognito Cognito-Benutzerrolle polly: SynthesizeSpeech permissions und einen Amazon Cognito Cognito-Identitätspool mit der zugehörigen IAM-Rolle. Im folgenden [Erstellen Sie die Ressourcen mit dem AWS CloudFormation](#polly-example-synthesize-to-s3-create-resources) Abschnitt wird beschrieben, wie Sie diese Ressourcen erstellen.

**Anmerkung**  
In diesem Beispiel wird Amazon Cognito verwendet, aber wenn Sie Amazon Cognito nicht verwenden, muss Ihr AWS Benutzer über die folgenden IAM-Berechtigungsrichtlinien verfügen  

****  

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

## Erstellen Sie die Ressourcen mit dem AWS CloudFormation
<a name="polly-example-synthesize-to-s3-create-resources"></a>

CloudFormation ermöglicht es Ihnen, AWS Infrastrukturbereitstellungen vorhersehbar und wiederholt zu erstellen und bereitzustellen. [Weitere Informationen zu CloudFormation finden Sie im AWS CloudFormation Benutzerhandbuch.](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/)

Um den CloudFormation Stapel zu erstellen:

1. Installieren und konfigurieren Sie die AWS CLI folgenden Anweisungen im [AWS CLI Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).

1. Erstellen Sie eine Datei mit dem Namen `setup.yaml` im Stammverzeichnis Ihres Projektordners und kopieren Sie den Inhalt [hier GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/polly/general-examples/src/setup.yaml) hinein. 
**Anmerkung**  
Die CloudFormation Vorlage wurde unter Verwendung der [hier AWS CDK verfügbaren Datei](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/resources/cdk/javascript_example_code_polly_aws_service/) generiert GitHub. Weitere Informationen zu finden Sie im [AWS Cloud Development Kit (AWS CDK) Entwicklerhandbuch](https://docs.aws.amazon.com/cdk/latest/guide/). AWS CDK

1. Führen Sie den folgenden Befehl von der Befehlszeile aus und *STACK\$1NAME* ersetzen Sie ihn durch einen eindeutigen Namen für den Stack.
**Wichtig**  
Der Stack-Name muss innerhalb einer AWS Region und eines AWS Kontos eindeutig sein. Sie können bis zu 128 Zeichen angeben. Zahlen und Bindestriche sind zulässig.

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

   Weitere Informationen zu den `create-stack` Befehlsparametern finden Sie in der [AWS CLI Befehlsreferenz](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-stack.html) und im [CloudFormation Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-creating-stack.html).

1. Navigieren Sie zur CloudFormation Managementkonsole, wählen Sie **Stacks**, wählen Sie den Stack-Namen und klicken Sie auf die Registerkarte **Ressourcen**, um eine Liste der erstellten Ressourcen anzuzeigen.  
![\[CloudFormation Ressourcen\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v3/developer-guide/images/cfn_polly.png)

## Laden Sie mit Amazon Polly aufgenommene Audiodaten auf Amazon S3 hoch
<a name="polly-example-synthesize-to-s3-example"></a>

Erstellen Sie ein Node.js-Modul mit dem Dateinamen `polly_synthesize_to_s3.js`. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich der Installation der erforderlichen Clients und Pakete. Geben Sie im Code die*REGION*, und die ein*BUCKET\$1NAME*. Um auf Amazon Polly zuzugreifen, erstellen Sie ein `Polly` Kundenservice-Objekt. *"IDENTITY\$1POOL\$1ID"*Ersetzen Sie es `IdentityPoolId` durch die **Seite „Beispiel“** des Amazon Cognito Cognito-Identitätspools, den Sie für dieses Beispiel erstellt haben. Dies wird auch an jedes Client-Objekt übergeben.

Rufen Sie die `StartSpeechSynthesisCommand` Methode des Amazon Polly Polly-Client-Serviceobjekts auf, synthetisieren Sie die Sprachnachricht und laden Sie sie in den Amazon S3 S3-Bucket hoch. 

```
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();
```

Diesen Beispielcode finden Sie [hier auf. GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/polly/general-examples/src/polly_synthesize_to_s3.js)