翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # レキシコンの管理 発音レキシコンを使用すると、単語の発音をカスタマイズできます。Amazon Polly では、AWS リージョンにレキシコンを保存できる API オペレーションを使用できます。これらのレキシコンは、その特定のリージョンに固有です。`SynthesizeSpeech` オペレーションを使用してテキストを合成するとき、そのリージョンから 1 つ以上のレキシコンを使用できます。これにより、合成が始まる前に、入力テキストに指定されたレキシコンが適用されます。詳細については、「[SynthesizeSpeech](API_SynthesizeSpeech.md)」を参照してください。 **注記** これらのレキシコンは、Pronunciation Lexicon Specification (PLS) の W3C 推奨事項に準拠する必要があります。詳細については、W3C ウェブサイトの「[Pronunciation Lexicon Specification (PLS) バージョン 1.0](https://www.w3.org/TR/pronunciation-lexicon/)」を参照してください。 以下は、音声合成エンジンでレキシコンを使用する方法の例です。 + 一般的な単語は、「g3t sm4rt」 (get smart) のように文字を数字に置き換えたスタイルで書かれる場合があります。人間はこれらの単語を正しく読むことができます。ただし、テキスト読み上げ機能 (TTS) エンジンでは文字をそのまま読み上げ、名前をスペルどおりに発音します。このような場合、Amazon Polly でレキシコンを活用し、合成された音声をカスタマイズできます。この例では、レキシコンで「g3t sm4rt」という単語に「get smart」というエイリアスを指定できます。 + テキスト内に W3C などの頭文字が使用されている場合があります。レキシコンを使用して W3C のエイリアスを定義すると、W3C は完全な形の「World Wide Web Consortium」に置き換えられて読み上げられます。 レキシコンにより、選択した言語で一般的でない単語を Amazon Polly が発音する方法をさらにコントロールできます。たとえば、音声記号を使用して発音を指定できます。詳細については、W3C ウェブサイトの「[Pronunciation Lexicon Specification (PLS) バージョン 1.0](https://www.w3.org/TR/pronunciation-lexicon/)」を参照してください。 **Topics** + [複数のレキシコンの使用](lexicons-applying.md) + [レキシコンのアップロード](managing-lexicons-console-upload.md) + [レキシコンの適用 (音声の合成）](managing-lexicons-console-synthesize-speech.md) + [コンソールでのレキシコンリストのフィルタリング](managing-lexicons-console-filter.md) + [コンソールでのレキシコンのダウンロード](managing-lexicons-console-download.md) + [レキシコンの削除](managing-lexicons-console-delete.md) # 複数のレキシコンの使用 テキストに最大 5 つのレキシコンを適用できます。テキストに適用する複数のレキシコンに同じ書記素がある場合、適用順序により音声の結果が異なります。例えば、「Hello, my name is Bob」というテキストがあり、異なるレキシコンで 2 つの語彙素が同じ書記素 `Bob` を使用しているとします。 **LexA** ``` Bob Robert ``` **LexB** ``` Bob Bobby ``` レキシコンが LexA の後に LexB という順番になっている場合、合成された音声は、「Hello, my name is Robert.」となります。LexB の後に LexA という順番になっている場合、合成された音声は、「Hello, my name is Bobby.」となります。 **Example – LexB の前に LexA を適用する** ``` aws polly synthesize-speech \ --lexicon-names LexA LexB \ --output-format mp3 \ --text 'Hello, my name is Bob' \ --voice-id Justin \ bobAB.mp3 ``` **音声出力:** 「Hello, my name is Robert.」 **Example – LexA の前に LexB を適用する** ``` aws polly synthesize-speech \ --lexicon-names LexB LexA \ --output-format mp3 \ --text 'Hello, my name is Bob' \ --voice-id Justin \ bobBA.mp3 ``` **音声出力:** 「Hello, my name is Bobby.」 Amazon Polly コンソールを使用したレキシコンの適用の詳細については、[レキシコンの適用 (音声の合成）](managing-lexicons-console-synthesize-speech.md)を参照してください。 # レキシコンのアップロード 使用するレキシコンは、Pronunciation Lexicon Specification (PLS) の W3C 推奨事項に準拠している必要があります。詳細については、W3C ウェブサイトの「[Pronunciation Lexicon Specification (PLS) バージョン 1.0](https://www.w3.org/TR/pronunciation-lexicon/#S4.7)」を参照してください。 ------ #### [ Console - Lexicons tab ] 発音レキシコンを使用するには、最初にアップロードする必要があります。コンソールにはレキシコンをアップロードできる場所が 2 つあります。[**Text-to-Speech**] タブ、および [**Lexicons**] タブです。 以下のプロセスでは、選択した言語で一般的でない語句がどのように発音されるかをカスタマイズするのに使用できるレキシコンを追加する方法を説明します。 **レキシコンを [Lexicons] タブから追加するには** 1. AWS マネジメントコンソール にサインインして、Amazon Polly コンソール ([https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)) を開きます。 1. [**Lexicons**] タブを選択します。 1. **[Upload lexicon]** (レキシコンのアップロード) を選択します。 1. レキシコンの名前を入力し、**[Choose a lexicon file]** (レキシコンファイルの選択) を使用して、アップロードするレキシコンを見つけます。アップロードできるのは、.pls または.xml 拡張子を持つ PLS ファイルのみです。 1. **[Upload lexicon]** (レキシコンのアップロード) を選択します。同じ名前でレキシコンが (.pls または .xml ファイルにかかわりなく) 既に存在する場合、レキシコンをアップロードすると既存のレキシコンは上書きされます。 ------ #### [ Console - TTS tab ] **レキシコンを [テキスト読み上げ機能] タブから追加するには** 1. AWS マネジメントコンソール にサインインして、Amazon Polly コンソール ([https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)) を開きます。 1. [**Text-to-Speech (テキスト読み上げ機能)**] タブを選択します。 1. **[Additional settings]** (詳細設定) を展開し、**[Customize pronunciation]** (発音のカスタマイズ) を有効にしてから、**[Upload lexicon]** (レキシコンのアップロード) を選択します。 1. レキシコンの名前を入力し、**[Choose a lexicon file]** (レキシコンファイルの選択) を使用して、アップロードするレキシコンを見つけます。.pls および .xml 拡張子を持つ PLS ファイルのみ使用できます。 1. **[Upload lexicon]** (レキシコンのアップロード) を選択します。同じ名前のレキシコンが (.pls または .xml ファイルにかかわりなく) 既に存在する場合、レキシコンをアップロードすると既存のレキシコンは上書きされます。 ------ #### [ AWS CLI - one lexeme ] Amazon Polly では、[PutLexicon](API_PutLexicon.md) を使用してアカウントの特定の AWS リージョンに発音レキシコンを保存できます。次に、サービスがテキストを合成し始める前に適用する [SynthesizeSpeech](API_SynthesizeSpeech.md) リクエストに保存した 1 つ以上のレキシコンを指定できます。詳細については、「[レキシコンの管理](managing-lexicons.md)」を参照してください。 次の W3C PLS 準拠のレキシコンについて考えます。 ``` W3C World Wide Web Consortium ``` 次の点に注意してください。 + `` 要素で指定された 2 つの属性: + `xml:lang` 属性は、レキシコンが適用される言語コード `en-US` を指定します。Amazon Polly は、`SynthesizeSpeech` コールで指定された音声が同じ言語コード (en-US) であれば、この例のレキシコンを使用できます。 **注記** 音声に関連付けられている言語コードを探すため、`DescribeVoices` オペレーションを使用できます。   + `alphabet` 属性は `IPA` を指定します。つまり、国際音声記号 (IPA) のアルファベットが発音に使用されます。IPA は、発音を表記するためのアルファベットの 1 つです。Amazon Polly は、Extended Speech Assessment Methods Phonetic Alphabet (X-SAMPA) もサポートしています。   + `` 要素は、``(単語のテキスト表記) と `` の間のマッピングを説明します。 このレキシコンをテストするには、以下を実行します。 1. `example.pls` という名前でレキシコンを保存します。 1. us-east-2 リージョンに (`put-lexicon` の名前で) レキシコンを保存するため AWS CLI `w3c` コマンドを実行します。 ``` aws polly put-lexicon \ --name w3c \ --content file://example.pls ``` 1. `synthesize-speech` コマンドを実行してサンプルテキストを音声ストリーム (`speech.mp3`) に合成し、オプションの `lexicon-name` パラメーターを指定します。 ``` aws polly synthesize-speech \ --text 'W3C is a Consortium' \ --voice-id Joanna \ --output-format mp3 \ --lexicon-names="w3c" \ speech.mp3 ``` 1. 結果の `speech.mp3` を再生し、テキスト内の W3C という単語が World Wide Web Consortium に置き換わっていることを確認します。 前の例のレキシコンでは、エイリアスを使用します。レキシコンで説明されている IPA のアルファベットは使用されません。以下のレキシコンでは、IPA のアルファベットで `` 要素を使用して音声発音を指定します。 ``` pecan pɪˈkɑːn ``` このレキシコンをテストするため、同じ手順に従います。「pecan」という単語がある入力テキスト (「Pecan pie is delicious」など) を必ず指定します。 PutLexicon API オペレーションの追加コードサンプルについては、以下のリソースを参照してください。 + Java サンプル: [PutLexicon](PutLexiconSample.md) + Python (Boto3) サンプル: [PutLexicon](PutLexiconSamplePython.md) ------ #### [ AWS CLI - multiple lexemes ] Amazon Polly では、[PutLexicon](API_PutLexicon.md) を使用してアカウントの特定の AWS リージョンに発音レキシコンを保存できます。次に、サービスがテキストを合成し始める前に適用する [SynthesizeSpeech](API_SynthesizeSpeech.md) リクエストに保存した 1 つ以上のレキシコンを指定できます。詳細については、「[レキシコンの管理](managing-lexicons.md)」を参照してください。 この例では、レキシコンで指定する語彙素は合成の入力テキストのみに適用されます。次のレキシコンについて考えます。 ``` W3C World Wide Web Consortium W3C WWW Consortium Consortium Community ``` レキシコンが 3 つの語彙素を指定し、そのうち 2 つは書記素 W3C のエイリアスを次のとおり定義します。 + 最初の ` 要素はエイリアス (World Wide Web Consortium) を定義します。 + 2 つめの `` は、代替エイリアス (WWW Consortium) を定義します。 Amazon Polly は、レキシコンにあるどの書記素にも最初の置き換えを使用します。 3 つめの `` は、Consortium という単語に対する置き換え (Community) を定義します。 まず、このレキシコンをテストします。次のサンプルテキストを音声ファイル (`speech.mp3`) に合成する場合、`SynthesizeSpeech` への呼び出しでレキシコンを指定します。 ``` The W3C is a Consortium ``` `SynthesizeSpeech` は、まずレキシコンを次のように適用します。 + 最初の語彙素では、W3C という単語は World Wide Web Consortium に変更されます。変更したテキストは次のように表示されます。 ``` The World Wide Web Consortium is a Consortium ``` + 3 番目の語彙素で定義したエイリアスは、元のテキストの一部にある Consortium という単語にのみ適用され、以下のテキストの結果となります。 ``` The World Wide Web Consortium is a Community. ``` AWS CLI を使用してこれを以下のようにテストできます。 1. `example.pls` という名前でレキシコンを保存します。 1. us-east-2 リージョンに w3c の名前でレキシコンを保存するため `put-lexicon` コマンドを実行します。 ``` aws polly put-lexicon \ --name w3c \ --content file://example.pls ``` 1. w3c レキシコンは返されたレキシコンのリストにあることを確認するために、`list-lexicons` コマンドを実行します。 ``` aws polly list-lexicons ``` 1. `synthesize-speech` コマンドを実行してサンプルテキストを音声ファイル (`speech.mp3`) に合成し、オプションの `lexicon-name` パラメーターを指定します。 ``` aws polly synthesize-speech \ --text 'W3C is a Consortium' \ --voice-id Joanna \ --output-format mp3 \ --lexicon-names="w3c" \ speech.mp3 ``` 1. 生成された `speech.mp3` ファイルを再生して、合成された音声がテキストの変更を反映していることを確認します。 PutLexicon API オペレーションの追加コードサンプルについては、以下のリソースを参照してください。 + Java サンプル: [PutLexicon](PutLexiconSample.md) + Python (Boto3) サンプル: [PutLexicon](PutLexiconSamplePython.md) ------ # レキシコンの適用 (音声の合成） 使用するレキシコンは、Pronunciation Lexicon Specification (PLS) の W3C 推奨事項に準拠している必要があります。詳細については、W3C ウェブサイトの「[Pronunciation Lexicon Specification (PLS) バージョン 1.0](https://www.w3.org/TR/pronunciation-lexicon/#S4.7)」を参照してください。 ------ #### [ Console ] 次の手順では、「W3C」を「World Wide Web Consortium」に置き換える `W3c.pls` レキシコンを適用することで、入力テキストにレキシコンを適用する方法を示します。テキストに複数のレキシコンを適用する場合、最初の一致が後の一致より優先する上から下の順序で適用されます。レキシコンで指定した言語が選択した言語と同じ場合、レキシコンはテキストにのみ適用されます。 レキシコンはプレーンテキストまたは SSML 入力に適用できます。 **Example – W3C.pls レキシコンを適用する** この演習に必要なレキシコンを作成するには、[レキシコンのアップロード](managing-lexicons-console-upload.md) を参照してください。トピックの一番上に示されている W3C.pls レキシコンを作成するには、空のテキストファイルを使用します。このファイルを保存する場所を忘れないでください。 **W3C.pls レキシコンを入力に適用するには** この例では、「W3C」を「World Wide Web Consortium」に置き換えるレキシコンを説明します。この実習結果を、英語と別の言語の両方で「[コンソールでの SSML の使用](ssml-to-speech-console.md)」の例と比較してみてください。 1. AWS マネジメントコンソール にサインインして、Amazon Polly コンソール ([https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)) を開きます。 1. 次のいずれかを行います: + **[SSML]** を無効にし、テキスト入力ボックスにこのテキストを入力するか貼り付けます。 ``` He was caught up in the game. In the middle of the 10/3/2014 W3C meeting he shouted, "Score!" quite loudly. ``` + **[SSML]** を有効にし、テキスト入力ボックスにこのテキストを入力するか貼り付けます。 ``` He wasn't paying attention. In the middle of the 10/3/2014 W3C meeting he shouted, "Score!" quite loudly. ``` 1. **[Language]** (言語) リストから **[English US]** を選択し、このテキストに使用する音声を選択します。 1. **[Additional settings]** (詳細設定) を展開し、**[Customize pronunciation]** (発音のカスタマイズ) を有効にします。 1. レキシコンのリストから、`W3C (English, US)` を選択します。 `W3C (English, US)` レキシコンがリストにない場合、[**Upload lexicon**] を選択してアップロードし、リストから選択します。このレキシコンの作成については、「[レキシコンのアップロード](managing-lexicons-console-upload.md)」を参照してください。 1. 音声をすぐに聞くには、**[Listen]** (聴く) を選択します。 1. 音声をファイルに保存するには、 1. [**ダウンロード**] を選択します。 1. 別のファイル形式に変更するには、**[Speech file format settings]** (音声ファイル形式の設定) を有効にし、目的のファイル形式を選択して、**[Download]** (ダウンロード) を選択します。 前の手順を繰り返しますが、異なる言語を選択し、出力の違いを確認してください。 ------ #### [ AWS CLI ] `SynthesizeSpeech` への呼び出しでは、複数のレキシコンを指定できます。この場合、最初に指定したレキシコン (左から右の順序) により、他のすべてのレキシコンがオーバーライドされます。 次の 2 つのレキシコンを考えます。各レキシコンは、同じ書記素 W3C の異なるエイリアスを示していることに注意してください。 + レキシコン 1: `w3c.pls` ``` W3C World Wide Web Consortium ``` + レキシコン 2: `w3cAlternate.pls` ``` W3C WWW Consortium ``` これらのレキシコンを `w3c` および `w3cAlternate` としてそれぞれ保存するとします。`w3c` 呼び出しでレキシコンの順序を指定 (`w3cAlternate` の次に `SynthesizeSpeech`) すると、最初のレキシコンで指定した W3C のエイリアスは 2 番目より優先されます。レキシコンをテストするには、以下を実行します。 1. レキシコンを `w3c.pls` および `w3cAlternate.pls` という名前でローカルにファイルとして保存します。 1. `put-lexicon` AWS CLI コマンドを使用してこれらのレキシコンをアップロードします。 + `w3c.pls` レキシコンをアップロードし、`w3c` として保存します。 ``` aws polly put-lexicon \ --name w3c \ --content file://w3c.pls ``` + ` w3cAlternate.pls` レキシコンをサービスに `w3cAlternate` としてアップロードします。 ``` aws polly put-lexicon \ --name w3cAlternate \ --content file://w3cAlternate.pls ``` 1. `synthesize-speech` コマンドを実行してサンプルテキストを音声ストリーム (`speech.mp3`) に合成し、`lexicon-name` パラメーターを使用して両方のレキシコンを指定します。 ``` aws polly synthesize-speech \ --text 'PLS is a W3C recommendation' \ --voice-id Joanna \ --output-format mp3 \ --lexicon-names '["w3c","w3cAlternative"]' \ speech.mp3 ``` 1. `speech.mp3` の結果のテスト 以下のようになるはずです。 ``` PLS is a World Wide Web Consortium recommendation ``` ------ # コンソールでのレキシコンリストのフィルタリング 次の手順では、選択した言語のレキシコンのみが表示されるようにレキシコンのリストをフィルタリングする方法を説明します。 ------ #### [ Console ] **言語ごとにリスト表示されるレキシコンをフィルタリングするには** 1. AWS マネジメントコンソール にサインインして、Amazon Polly コンソール ([https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)) を開きます。 1. [**Lexicons**] タブを選択します。 1. **[Any language]** (任意の言語) を選択します。 1. 言語のリストから、フィルタリングする言語を選択します。 選択した言語のレキシコンのみがリストに表示されます。 ------ #### [ AWS CLI ] Amazon Polly は、特定の AWS リージョンのアカウントの発音レキシコンのリストを取得するのに使用できる [ListLexicons](API_ListLexicons.md) API オペレーションを提供します。次の AWS CLI 呼び出しでは、us-east-2 リージョンのアカウントのレキシコンをリスト表示します。 ``` aws polly list-lexicons ``` 次はレスポンスの例で、`w3c` と `tomato` という 2 つのレキシコンを表示しています。各レキシコンで、レスポンスは、レキシコンが適用される言語コード、レキシコンで定義されている語彙素の数、バイト単位のサイズなどのメタデータを返します。言語コードは、レキシコンで定義されている語彙素が適用される言語およびロケールを示します。 ``` { "Lexicons": [ { "Attributes": { "LanguageCode": "en-US", "LastModified": 1474222543.989, "Alphabet": "ipa", "LexemesCount": 1, "LexiconArn": "arn:aws:polly:aws-region:account-id:lexicon/w3c", "Size": 495 }, "Name": "w3c" }, { "Attributes": { "LanguageCode": "en-US", "LastModified": 1473099290.858, "Alphabet": "ipa", "LexemesCount": 1, "LexiconArn": "arn:aws:polly:aws-region:account-id:lexicon/tomato", "Size": 645 }, "Name": "tomato" } ] } ``` 以下のリソースには、ListLexicons オペレーションに関する追加情報が含まれています。 + Java サンプル: [ListLexicons](ListLexiconsSample.md) + Python (Boto3) サンプル: [ListLexicon](ListLexiconSamplePython.md) ------ # コンソールでのレキシコンのダウンロード 以下のプロセスでは、1 つ以上のレキシコンをダウンロードする方法を説明します。ファイルにあるレキシコンのエントリの追加、削除、または変更をし、レキシコンを最新の状態に保つために再度アップロードします。 ------ #### [ Console ] **1 つ以上のレキシコンをダウンロードするには** 1. AWS マネジメントコンソール にサインインして、Amazon Polly コンソール ([https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)) を開きます。 1. [**Lexicons**] タブを選択します。 1. ダウンロードするレキシコンを 1 つ、または複数選択します。 1. 1 つのレキシコンをダウンロードするには、リストから名前を選択します。 1. 単一の圧縮アーカイブファイルとして複数のレキシコンをダウンロードするには、リストにあるダウンロードする各エントリの横にあるチェックボックスを選択します。 1. [**ダウンロード**] を選択します。 1. レキシコンをダウンロードするフォルダを開きます。 1. **[保存]** を選択します。 ------ #### [ AWS CLI ] Amazon Polly は、特定のリージョンのアカウントに保存した発音レキシコンのコンテンツを取得するために、[GetLexicon](API_GetLexicon.md) API オペレーションを提供します。 次の `get-lexicon` AWS CLI コマンドは、`example` レキシコンのコンテンツを取得します。 ``` aws polly get-lexicon \ --name example ``` まだアカウントに保存したレキシコンがないなら、`PutLexicon` オペレーションを使用してレキシコンを保存できます。詳細については、「[レキシコンのアップロード](managing-lexicons-console-upload.md)」を参照してください。 レスポンスの例を次に示します。レキシコンのコンテンツに加えて、レスポンスでは、レキシコンが適用される言語コード、レキシコンで定義されている語彙素の数、リソースの Amazon リソースネーム (ARN)、レキシコンのサイズ (バイト単位) などのメタデータを返します。`LastModified` 値は、Unix タイムスタンプです。 ``` { "Lexicon": { "Content": "lexicon content in plain text PLS format", "Name": "example" }, "LexiconAttributes": { "LanguageCode": "en-US", "LastModified": 1474222543.989, "Alphabet": "ipa", "LexemesCount": 1, "LexiconArn": "arn:aws:polly:us-east-2:account-id:lexicon/example", "Size": 495 } } ``` 以下のリソースには、GetLexicon オペレーションに関する追加のコードサンプルが含まれています。 + Java サンプル: [GetLexicon](GetLexiconSample.md) + Python (Boto3) サンプル: [GetLexicon](GetLexiconSamplePython.md) ------ # レキシコンの削除 以下のプロセスでは、レキシコンを削除する方法を説明します。レキシコンを削除した後は、もう一度レキシコンを使用する前に再度追加する必要があります。個々のレキシコンの横にあるチェックボックスを選択して、1 つ以上のレキシコンを同時に削除できます。 ------ #### [ Console ] **レキシコンを削除するには** 1. AWS マネジメントコンソール にサインインして、Amazon Polly コンソール ([https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)) を開きます。 1. [**Lexicons**] タブを選択します。 1. 削除するレキシコンをリストから 1 つ以上選択します。 1. **[削除]** を選択します。 1. 確認テキストを入力し、リージョンからレキシコンを削除するには **[Delete]** (削除) を、そのままにするには **[Cancel]** (キャンセル) を選択します。 ------ #### [ AWS CLI ] Amazon Polly は、アカウントの特定の AWS リージョンから発音レキシコンを削除するために [DeleteLexicon](API_DeleteLexicon.md) API オペレーションを提供します。以下の AWS CLI は指定したレキシコンを削除します。 次の AWS CLI の例は、Unix、Linux、および macOS 用にフォーマットされています。Windows の場合は、各行末のバックスラッシュ (\$1) Unix 連結文字をカレット (^) に置き換え、入力テキストは二重引用符 (") で囲み、内部タグは一重引用符 (') で囲みます。 ``` aws polly delete-lexicon \ --name example ``` 以下のリソースには、DeleteLexicon オペレーションに関する追加情報が含まれています。 + Java サンプル: [DeleteLexicon](DeleteLexiconSample.md) + Python (Boto3) サンプル: [DeleteLexicon](DeleteLexiconPython.md) ------