Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用した Amazon Polly の例 AWS CLI
<a name="cli_2_polly_code_examples"></a>

次のコード例は、Amazon Polly AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。

**Topics**
+ [アクション](#actions)

## アクション
<a name="actions"></a>

### `delete-lexicon`
<a name="polly_DeleteLexicon_cli_2_topic"></a>

次のコード例は、`delete-lexicon` を使用する方法を示しています。

**AWS CLI**  
**レキシコンを削除するには**  
次の `delete-lexicon` の例は、指定されたレキシコンを削除します。  

```
aws polly delete-lexicon \
    --name w3c
```
このコマンドでは何も出力されません。  
詳細については、「Amazon Polly ディベロッパーガイド」の「[DeleteLexicon オペレーションの使用](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html)」を参照してください。**  
+  API の詳細については、AWS CLI コマンドリファレンスの「[DeleteLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html)」を参照してください。**

### `get-lexicon`
<a name="polly_GetLexicon_cli_2_topic"></a>

次のコード例は、`get-lexicon` を使用する方法を示しています。

**AWS CLI**  
**レキシコンの内容を取得するには**  
次の `get-lexicon` の例は、指定された発音レキシコンの内容を取得します。  

```
aws polly get-lexicon \
    --name w3c
```
出力:  

```
{
    "Lexicon": {
        "Content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<lexicon version=\"1.0\" \n      xmlns=    \"http://www.w3.org/2005/01/pronunciation-lexicon\"\n      xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n          xsi:schemaLocation=\"http://www.w3.org/2005/01/pronunciation-lexicon \n        http://www.w3.org/TR/2007/CR-pronunciation-    lexicon-20071212/pls.xsd\"\n      alphabet=\"ipa\" \n      xml:lang=\"en-US\">\n  <lexeme>\n    <grapheme>W3C</grapheme>\n        <alias>World Wide Web Consortium</alias>\n  </lexeme>\n</lexicon>\n",
        "Name": "w3c"
    },
    "LexiconAttributes": {
        "Alphabet": "ipa",
        "LanguageCode": "en-US",
        "LastModified": 1603908910.99,
        "LexiconArn": "arn:aws:polly:us-west-2:880185128111:lexicon/w3c",
        "LexemesCount": 1,
        "Size": 492
    }
}
```
詳細については、「Amazon Polly ディベロッパーガイド」の「[GetLexicon オペレーションの使用](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html)」を参照してください。**  
+  API の詳細については、AWS CLI コマンドリファレンスの「[GetLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html)」を参照してください。**

### `get-speech-synthesis-task`
<a name="polly_GetSpeechSynthesisTask_cli_2_topic"></a>

次のコード例は、`get-speech-synthesis-task` を使用する方法を示しています。

**AWS CLI**  
**音声合成タスクに関する情報を取得するには**  
次の `get-speech-synthesis-task` の例は、指定された音声合成タスクに関する情報を取得します。  

```
aws polly get-speech-synthesis-task \
    --task-id 70b61c0f-57ce-4715-a247-cae8729dcce9
```
出力:  

```
{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "completed",
        "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}
```
詳細については、「Amazon Polly ディベロッパーガイド」の「[長いオーディオファイルの作成 (CLI)](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html)」を参照してください。**  
+  API の詳細については、AWS CLI コマンドリファレンスの「[GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html)」を参照してください。**

### `list-lexicons`
<a name="polly_ListLexicons_cli_2_topic"></a>

次のコード例は、`list-lexicons` を使用する方法を示しています。

**AWS CLI**  
**レキシコンを一覧表示するには**  
次の `list-lexicons` の例は、発音レキシコンを一覧表示します。  

```
aws polly list-lexicons
```
出力:  

```
{
    "Lexicons": [
        {
            "Name": "w3c",
            "Attributes": {
                "Alphabet": "ipa",
                "LanguageCode": "en-US",
                "LastModified": 1603908910.99,
                "LexiconArn": "arn:aws:polly:us-east-2:123456789012:lexicon/w3c",
                "LexemesCount": 1,
                "Size": 492
            }
        }
    ]
}
```
詳細については、「Amazon Polly ディベロッパーガイド」の「[ListLexicons オペレーションの使用](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html)」を参照してください。**  
+  API の詳細については、AWS CLI コマンドリファレンスの「[ListLexicons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html)」を参照してください。**

### `list-speech-synthesis-tasks`
<a name="polly_ListSpeechSynthesisTasks_cli_2_topic"></a>

次のコード例は、`list-speech-synthesis-tasks` を使用する方法を示しています。

**AWS CLI**  
**音声合成タスクを一覧表示するには**  
次の `list-speech-synthesis-tasks` の例では、音声合成タスクを一覧表示します。  

```
aws polly list-speech-synthesis-tasks
```
出力:  

```
{
    "SynthesisTasks": [
        {
            "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
            "TaskStatus": "completed",
            "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
            "CreationTime": 1603911042.689,
            "RequestCharacters": 1311,
            "OutputFormat": "mp3",
            "TextType": "text",
            "VoiceId": "Joanna"
        }
    ]
}
```
詳細については、「Amazon Polly ディベロッパーガイド」の「[長いオーディオファイルの作成 (CLI)](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html)」を参照してください。**  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html)」を参照してください。

### `put-lexicon`
<a name="polly_PutLexicon_cli_2_topic"></a>

次のコード例は、`put-lexicon` を使用する方法を示しています。

**AWS CLI**  
**レキシコンを保存するには**  
次の `put-lexicon` の例は、指定された発音レキシコンを保存します。`example.pls` ファイルは W3C PLS 準拠のレキシコンを指定します。  

```
aws polly put-lexicon \
    --name w3c \
    --content file://example.pls
```
`example.pls` の内容  

```
{
    <?xml version="1.0" encoding="UTF-8"?>
    <lexicon version="1.0"
        xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
            http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
        alphabet="ipa"
        xml:lang="en-US">
        <lexeme>
            <grapheme>W3C</grapheme>
            <alias>World Wide Web Consortium</alias>
        </lexeme>
    </lexicon>
}
```
このコマンドでは何も出力されません。  
詳細については、「Amazon Polly ディベロッパーガイド」の「[PutLexicon オペレーションの使用](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html)」を参照してください。**  
+  API の詳細については、AWS CLI コマンドリファレンスの「[PutLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html)」を参照してください。**

### `start-speech-synthesis-task`
<a name="polly_StartSpeechSynthesisTask_cli_2_topic"></a>

次のコード例は、`start-speech-synthesis-task` を使用する方法を示しています。

**AWS CLI**  
**テキストを合成するには**  
次の `start-speech-synthesis-task` の例は、`text_file.txt` 内のテキストを合成し、生成された MP3 ファイルを指定されたバケットに保存します。  

```
aws polly start-speech-synthesis-task \
    --output-format mp3 \
    --output-s3-bucket-name amzn-s3-demo-bucket \
    --text  file://text_file.txt \
    --voice-id Joanna
```
出力:  

```
{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "scheduled",
        "OutputUri": "https://s3.us-east-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}
```
詳細については、「Amazon Polly ディベロッパーガイド」の「[長いオーディオファイルの作成 (CLI)](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html)」を参照してください。**  
+  API の詳細については、AWS CLI コマンドリファレンスの「[StartSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html)」を参照してください。**