Unreal Engine の Text To Speech のクイックスタートガイド | Unreal Engine 5.3 ドキュメンテーション

このガイドでは、2 つのボタンを備えるシンプルな Text To Speech ウィジェットを作成して、有効化する方法について説明します。各ボタンは、ユーザーがクリックするとテキスト文字列を読み上げます。

必要な知識と設定

このページに概要を記載している手順を実行する前に、以下を実行する必要があります。

Unreal Motion Graphics (UMG) の UI エディタの基本原理を理解していることを確認する。
新しい Unreal Engine プロジェクトを作成する。希望するどのテンプレートでも使用できます。
プロジェクトで Text To Speech プラグインを有効にする。この手順を実行するためにさらにサポートが必要な場合は、「プラグインを操作する」ページを参照してください。

新しいウィジェットブループリントを作成する

このステップでは、画面上に表示するウィジェットを作成します。

コンテンツブラウザ または [Content Drawer (コンテンツドロワー)] で空白の領域を右クリックします。表示される コンテキストメニュー で、[User Interface (ユーザーインターフェース)] > [Widget Blueprint (ウィジェットブループリント)] を選択します。
User Widget] クラスを選択して [Select] をクリックしてウィジェットを作成します。
新しいウィジェットに「MyWidget」という名前を付けます。
ウィジェットブループリント をダブルクリックして ウィジェットエディタ で開き、以下に示すように、2 つのボタンを備えるシンプルなレイアウトを作成します。ボタンのサイズや配置は、このチュートリアルでは、それほど重要ではなく、簡単にクリックできれば十分です。
ウィジェットを [Compile (コンパイル)] して [Save (保存)] し、ウィジェットエディタを最小化します。

レベルブループリントにウィジェットを追加する

次に、ウィジェットをレベルブループリントに追加し、ゲーム開始時に画面上で描画されるようにします。

メインツールバー から、レベルブループリント を開きます。
レベルブループリント で、Event BeginPlay ノードの実行ピンからドラッグします。「Create Widget」を検索して選択し、Enter キーを押してノードを作成します。
Create Widget ノードの実行ピンからドラッグし、Add to Viewport ノードを作成します。
Add to Viewport ノードの実行ピンからドラッグして、Set Input Mode UI Only ノードを作成します。

このノードは、プレイヤーの入力に反応するゲーム要素が UI のみであることをウィジェットに伝えます。ユーザーからのその他すべての入力は、たとえそのコントロールにアクションがバインドされていても、ゲームプレイのアクションに変換されません。
ブループリントエディタ の空白の領域を右クリックして、Get Player Controller ノードを作成します。
手順 2 で作成した Construct Widget ノードの Return Value ピンを、以下のピンに接続します。
- Add to Viewport ノードの Target。
- Set Input Mode UI Only ノードの In Widget to Focus。
手順 5 で作成した Get Player Controller ノードの Return Value ピンを Set Input Mode UI Only ノードの Player Controller ピンに接続します。

この段階では、レベルブループリントは、次の画像のようになります。
Get Player Controller ノードの Return Value ピンからドラッグして、Set Show Mouse Cursor ノードを作成します。このノードの [Show Mouse Cursor (マウスカーソルを表示)] チェックボックスをオンにします。
Set Input Mode UI Only ノードの出力ピンを Set Show Mouse Cursor ノードの入力ピンに接続しま
Create Widget ノードの Class 値を、前のセクションで作成した MyWidget ウィジェットに設定します。
ブループリントを コンパイル して保存します。

完成したレベルブループリントは、以下のようになります。

画像をクリックしてフルサイズで表示

これで、レベルブループリントを閉じることができます。

Text to Speech 文字列を追加する

次に、各ボタンが「話す」ためのチャンネルを作成し、読み上げる文字列を入力します。

ウィジェットの ウィジェットエディタ に戻ります。ウィジェットエディタが閉じている場合は、コンテンツブラウザ で MyWidget ウィジェットをダブルクリックして、再び開きます。
作成したボタンのいずれかをクリックします。次に、右側の [Details] パネルで、[Events (イベント)] まで下にスクロールして、(+) ボタンをクリックして、新しい On Clicked イベントを追加します。

この操作により、ウィジェットの グラフ が開き、このボタンのための新しい On Clicked ノードが作成されます。
グラフ内で右クリックして、新しい Get TextToSpeechEngineSubsystem ノードを作成します。

このノードが表示されない場合は、プロジェクトで Text To Speech プラグインが有効になっていることを確認します。
Text to Speech Engine Subsystem ノードからドラッグして、新しい Add Default Channel ノードを作成します。On Clicked イベントを Add Default Channel ノードの input ピンに接続します。
Add Default Channel ノードで、New Channel ID プロパティを右クリックし、コンテキストメニューから Promote to Variable を選択します。
右側の [Details] パネルで、Variable Name プロパティを使用して、変数に「Channel One」という名前を付けます。
Text to Speech Engine Subsystem ノードから再度ドラッグして、新しい Activate Channel ノードを作成します。Add Default Channel ノードの出力ピンを Activate Channel ノードの入力ピンに接続します。
手順 4 で作成した Channel One 変数を Activate Channel ノードの Channel ID ピンに接続します。

この段階で、ブループリントは次のようになっています。

画像をクリックしてフルサイズで表示
Text to Speech Engine Subsystem ノードから再度ドラッグして、新しい Speak on Channel ノードを作成します。Activate Channel ノードの出力ピンを Speak on Channel ノードの入力ピンに接続します。
手順 4 で作成した Channel One 変数を Activate Channel ノードの Channel ID ピンに接続します。
Speak on Channel ノードの String to Speak ピンからドラッグして、新しい To String (Text) ノードを作成します。
前のステップで作成した to String (Text) ノードの入力ピンからドラッグして、新しい Format Text ノードを作成します。
Format Text ノードの Format ボックスで言葉にしたいテキストを入力します。
作成した 2 つ目のボタンについて、上記の手順 1 ～ 12 を繰り返し、必要に応じて [Channel One] を [Channel Two] に変更します。

クリック＆ドラッグで複数のブループリントノードを選択すると、ブループリントノードをコピー＆ペーストできます。これにより、同じ手動の手順を何度も行う必要性が軽減されます
ブループリントを コンパイル して、保存します。