テキスト読み上げの追加 | 文書 - Roblox クリエーターハブ

テキスト読み上げは、テキスト文字列を人工音声を使用して音声に変換する支援技術の一形態です。視覚、運動、または認知障害を持つプレイヤーにとってゲームのアクセシビリティを向上させるだけでなく、TTSを使用することで、すべての可能なナラティブシナリオのために音声を事前に録音する必要がなく、動的に音声を生成することができます。

Gingerbread House - Start .rbxlファイルを出発点として、Gingerbread House - Text-to-Speechを参照しながら、このチュートリアルでは、基本的なTTS音声とコンテキストに応じたTTS音声をゲームに追加する方法を示します。以下のガイダンスが含まれています：

UIの操作やチュートリアルなど、決して変わらない一般的なゲームプレイシナリオのためのTTSをトリガーする方法。
プレイヤーの行動、環境の状態、または柔軟な目標に適応するようにTTSを構成する方法。

プロセスのどの時点でも行き詰まった場合は、Gingerbread House - Text-to-Speechを参照して進捗を比較できます。

音声オブジェクト

TTS音声を作成するには、このチュートリアル全体で使用する音声オブジェクトを理解することが重要です。TTS用の音声オブジェクトには5つの主要なタイプがあります：

AudioTextToSpeechオブジェクトは、テキスト文字列を音声に変換します。
AudioEmitterオブジェクトは、3D環境に音声を発信する仮想スピーカーです。
AudioListenerオブジェクトは、3D環境から音声を拾う仮想マイクです。
AudioDeviceOutputオブジェクトは、スピーカーやヘッドフォンなど、現実世界の物理ハードウェアデバイスです。
Wiresは、音声ストリームをあるオブジェクトから別のオブジェクトに運びます。

これらの音声オブジェクトはすべて、プレイヤーの行動に応じてTTS音声を発信するために連携して機能します。プレイヤーがヘッドセットを装着してラップトップでゲームをプレイしている例を用いて、3D音声がどのように機能するかを見てみましょう：

AudioTextToSpeechは、プレイヤーが非プレイ可能キャラクター（NPC）の近くのパートに触れるたびにテキストを音声に読み込み、変換します。
AudioEmitterは、NPCから3D環境にTTS音声のストリームを発信します。
Wireは、AudioTextToSpeechからAudioEmitterにストリームを運び、NPCから音声が出るようにします。
キャラクターの子であるAudioListenerオブジェクトは、その音声を3D環境内で聞き取り、ヘッドセットにフィードバックします。
AudioDeviceOutputオブジェクトは、AudioListenerからプレイヤーの物理スピーカー、またはこの場合はヘッドフォンに音声を運びます。

以下のセクションでは、これらのオブジェクトをより深く掘り下げ、基本的な音声とコンテキストに応じた音声の再生方法を学びます。これらのオブジェクトを今後の技術と共にレビューすることで、ゲームからプレイヤーへの音声のキャプチャとフィードバックの方法をより正確に予測できるようになります。

基本的なTTS

基本的なTTSは、プレイヤーや環境のコンテキストに関係なく、人工音声がテキスト文字列を読み上げる最も一般的な形式です。これは、プレイヤーがTTS音声をトリガーするたびに、言葉と人工音声が言葉を読み上げる方法が、プレイヤーの状態、行動、または環境の状態に関係なく一貫していることを意味します。

この形式のTTSは、プレイヤーがUIメニュー、チュートリアル、またはベンダーの提供や敵の叫びなどのルーチンNPCとのインタラクションに関与するようなほとんどのゲームプレイシナリオで役立ちます。Robloxは、これらのインタラクションのいずれかに対して実験できるさまざまな人工音声を提供しています。利用可能な音声の完全なリストと各音声の音声サンプルについては、人工音声のリストを参照してください。

サンプルのGingerbread House - Text-to-Speechプレースファイルで基本的な3D TTS音声を再現するには：

プレイヤーキャラクターに接続されたデフォルトリスナーを有効にします。
1. Explorerウィンドウで、SoundServiceを選択します。
2. Propertiesウィンドウで、DefaultListenerLocationをCharacterに設定します。ゲームを実行すると、エンジンは自動的に：
  - 各プレイヤーキャラクターのHumanoid.RootPartの下にAudioListenerを作成し、ゲーム内の音源の位置と音のスケールに応じて、実際のスピーカーで音がシフトするのを聞くことができます。
  - SoundServiceの下にAudioDeviceOutputを作成します。
Explorerウィンドウで、Workspace ⟩ DialogueVolumeに移動し、次に：
1. AudioTextToSpeechオブジェクトを挿入して、雪だるまの周りの音声生成器を作成します。
2. AudioEmitterオブジェクトを挿入して、DialogueVolumeから位置ストリームを発信します。
3. 音声生成器から音声エミッターにストリームを運ぶためにWireオブジェクトを挿入します。
AudioTextToSpeechオブジェクトを選択し、次にPropertiesウィンドウで：
1. Textを「Collect every single last gumpdrop to open my home!」に設定します。
2. VoiceIdを2に設定して、人工音声をイギリスの女性の声にエミュレートします。
3. Volumeを3に設定して、ゲーム内の他の音声ソースの上でTTS音声が聞こえるように高音量で再生します。
Wireを選択し、次にPropertiesウィンドウで：
1. SourceInstanceを新しいAudioTextToSpeechに設定して、この特定の音声生成器から音声を運ぶようにワイヤーを指定します。
2. TargetInstanceを新しいAudioEmitterに設定して、この特定の音声エミッターに音声を運ぶようにワイヤーを指定します。
Explorerウィンドウに戻り、StarterPlayer ⟩ StarterCharacterScriptsに移動し、次にLocalScriptを挿入し、名前をPlayBasicTTSAudioWhenInVolumeに変更し、以下のコードをローカルスクリプトに貼り付けます：

local Workspace = game:GetService("Workspace")
local Players = game:GetService("Players")

local humanoid = script.Parent:WaitForChild("Humanoid")
local volumeDetector = Workspace.DialogueVolume
local trigger = humanoid:WaitForChild("Animator")
local debounce = false
local localPlayer = Players.LocalPlayer

volumeDetector.Touched:Connect(function(hit)
  if debounce then 
    return
  end

  local hitCharacter = hit:FindFirstAncestorWhichIsA("Model")
  local hitPlayer = Players:GetPlayerFromCharacter(hitCharacter)
  
  if hitPlayer ~= localPlayer then
    return
  end

  debounce = true
  
  local audioTextToSpeech = Workspace.DialogueVolume.AudioTextToSpeech
  audioTextToSpeech:Play()
  audioTextToSpeech.Ended:Wait()

  debounce = false
end)

コードの説明

このスクリプトは、WorkspaceとPlayersサービスを取得して、子要素と機能を参照できるようにします。ゲームにロードまたは再出現する各プレイヤーキャラクターについて、スクリプトは以下を待ちます：

キャラクターのHumanoidとAnimatorオブジェクト。
ワークスペース内のDialogueVolumeという名前のボリュームオブジェクト。

ボリュームに何かが衝突すると、Touchedイベントハンドラ関数は、衝突したBasePartがキャラクターモデルの子孫である場合、最初の祖先であるModelを取得します。もしそうであれば、関数は次のようにします：

デバウンスをtrueに設定します。
TTS音声を再生し、終了するのを待ちます。
デバウンスをfalseに戻します。

デバウンスをfalseからtrueに、再生が終了した後に再びfalseに戻すことは、プレイヤーがボリュームに継続的に衝突する際に音声が繰り返しトリガーされるのを防ぐデバウンスパターンです。このデバウンスパターンの詳細については、デバウンス - 衝突を検出するを参照してください。

ゲームをプレイテストして、プレイヤーキャラクターが雪だるまの周りのボリュームに触れたときに指示のキャラクターダイアログを聞きます。

Text、VoiceID、Pitch、およびSpeedプロパティを新しい値に変更することで、この音声をさらに実験できます。生成された音声は、各シナリオのために新しい音声ファイルを録音してアップロードする必要なく、まったく異なるものになります。


VoiceID = 2 Pitch = -12 Speed = 2	VoiceID = 7 Pitch = 7 Speed = 0.8	VoiceID = 9 Pitch = 12 Speed = 1.2

コンテキストに応じたTTS

コンテキストに応じたTTSは、プレイヤー、環境の状態、またはゲームプレイの状態に関連してテキスト文字列を読み上げる、より高度な形式のテキスト読み上げです。これは、プレイヤーがTTS音声をトリガーするたびに、言葉と人工音声が言葉を読み上げる方法がそれに応じて適応することを意味します。

この形式のTTSは、方向音声の合図、目標の状態、またはユニークなNPCとのインタラクションなど、常に変化するゲームプレイシナリオに役立ちます。したがって、コンテキストに応じたTTSが正確であるためには、プレイヤーが環境を移動し、ゲームプレイの目標を達成する際にその状態を追跡できるように、ゲームプレイ要素を構成する必要があります。

このタスクを達成する方法は多くありますが、サンプルでは、プレイヤーがジンジャーブレッドハウスに入るために収集しなければならない各ガムドロップの色と位置を追跡するためにカスタム属性を使用します。属性の詳細については、プロパティと属性を参照してください。

各ガムドロップオブジェクトには、環境内の色と位置を説明する属性があります。

サンプルのGingerbread House - Text-to-Speechプレースファイルでコンテキストに応じた3D TTS音声を再現するには：

Explorerウィンドウで、Workspace ⟩ GumDropsに移動します。
黄色のガムドロップを追跡するために3つのカスタム属性を構成します。
1. 黄色のガムドロップを選択し、PropertiesウィンドウでAttributesセクションに移動し、プラスアイコンをクリックします。ポップアップダイアログが表示されます。
2. NameフィールドにColorDescriptionを入力します。
3. Typeドロップダウンメニューでstringを選択します。
4. Saveボタンをクリックします。
5. 新しいColorDescription属性をyellowに設定します。
6. このプロセスを使用して、次の値を使用してさらに2つの属性を作成します。
名前タイプ値
HintOrder number 0
LocationDescription string 滝のそば
緑のガムドロップを追跡するために3つのカスタム属性を構成します。
1. Explorerウィンドウで、緑のガムドロップを選択します。
2. Propertiesウィンドウで、次の値を使用して3つの属性を作成します。
名前タイプ値
ColorDescription string green
HintOrder number 1
LocationDescription string ledgeの上
赤いガムドロップを追跡するために3つのカスタム属性を構成します。
1. Explorerウィンドウで、赤いガムドロップを選択します。
2. Propertiesウィンドウで、次の値を使用して3つの属性を作成します。
名前タイプ値
ColorDescription string red
HintOrder number 2
LocationDescription string フェンスの後ろ
Explorerウィンドウで、Workspace ⟩ HintVolumeに移動し、次に：
1. AudioTextToSpeechオブジェクトを挿入して、トナカイの周りの音声生成器を作成します。
2. AudioEmitterオブジェクトを挿入して、HintVolumeから位置ストリームを発信します。
3. 音声生成器から音声エミッターにストリームを運ぶためにWireオブジェクトを挿入します。
Wireを選択し、次にPropertiesウィンドウで：
1. SourceInstanceを新しいAudioTextToSpeechに設定して、この特定の音声生成器から音声を運ぶようにワイヤーを指定します。
2. TargetInstanceを新しいAudioEmitterに設定して、この特定の音声エミッターに音声を運ぶようにワイヤーを指定します。
Explorerウィンドウに戻り、StarterPlayer ⟩ StarterCharacterScriptsに移動し、次にLocalScriptを挿入し、名前をPlayContextTTSAudioWhenInVolumeに変更し、以下のコードをローカルスクリプトに貼り付けます：

名前	タイプ	値
HintOrder	number	0
LocationDescription	string	滝のそば

名前	タイプ	値
ColorDescription	string	green
HintOrder	number	1
LocationDescription	string	ledgeの上

名前	タイプ	値
ColorDescription	string	red
HintOrder	number	2
LocationDescription	string	フェンスの後ろ

local Workspace = game:GetService("Workspace")
local Players = game:GetService("Players")

local humanoid = script.Parent:WaitForChild("Humanoid")
local volumeDetector = Workspace.HintVolume
local trigger = humanoid:WaitForChild("Animator")
local debounce = false
local localPlayer = Players.LocalPlayer

function getRemainingGumdrops(): {Part}
  local gumdropsFolder = Workspace.Gumdrops
  local gumdrops = gumdropsFolder:GetChildren()
  local remainingGumdrops = {};
  for _, gumdrop in gumdrops do
    if gumdrop:GetAttribute("Active") then
      remainingGumdrops[#remainingGumdrops + 1] = gumdrop
    end
  end
  table.sort(remainingGumdrops, function(a, b)
    return a:GetAttribute("HintOrder") < b:GetAttribute("HintOrder")
  end)
  return remainingGumdrops
end

function getReindeerHint(remainingGumdrops: {Part}): string
  local remainingGumdrops = getRemainingGumdrops()
  if (#remainingGumdrops == 0) then
    return "ガムドロップはもう残っていません。家の中を確認してください。"
  end
  local nextGumdrop = remainingGumdrops[1]
  local colorDescription = nextGumdrop:GetAttribute("ColorDescription")
  local locationDescription = nextGumdrop:GetAttribute("LocationDescription")
  local message = #remainingGumdrops > 1
    and  "残りのガムドロップは" .. #remainingGumdrops .. "個です。" .. locationDescription  .. "の" .. colorDescription  .. "のものを探してください。"
    or "残りのガムドロップは1個です。それは" .. colorDescription .. "で、" .. locationDescription .. "にあります。"
  return message
end

volumeDetector.Touched:Connect(function(hit)
  if debounce then 
    return
  end

  local hitCharacter = hit:FindFirstAncestorWhichIsA("Model")
  local hitPlayer = Players:GetPlayerFromCharacter(hitCharacter)
  
  if hitPlayer ~= localPlayer then
    return
  end

    print("プレイヤーがボリュームに触れました。")
    debounce = true

    local remainingGumdrops = getRemainingGumdrops()
    local message = getReindeerHint(remainingGumdrops)

    local audioTextToSpeech = Workspace.HintVolume.AudioTextToSpeech
    audioTextToSpeech.Text = message
    audioTextToSpeech:Play()
    audioTextToSpeech.Ended:Wait()

    debounce = false
end)

コードの説明

キャラクターのHumanoidとAnimatorオブジェクト。
ワークスペース内のHintVolumeという名前のボリュームオブジェクト。

スクリプトのgetRemainingGumdrops()関数は、Gumdropsフォルダー内のガムドロップPartオブジェクトのリストを返し、プレイヤーが収集したパートをフィルタリングします。残りのガムドロップは、各ガムドロップのHintOrder属性に従って特定の順序でソートされます。

スクリプトのgetReindeerHint(remainingGumdrops)関数は、getRemainingGumdrops()からのリストを受け取り、プレイヤーが見つける必要がある残りのガムドロップの場所を説明する文字列メッセージを返します。これには、次のガムドロップの色と位置の説明が含まれます。ただし、プレイヤーが環境内のすべてのガムドロップを収集した場合、文字列メッセージは、環境内のすべてのガムドロップを収集した後にどこに行くべきかを説明します。

デバウンスをtrueに設定します。
残りのガムドロップのリストと、プレイヤーが見つける必要がある次のガムドロップを説明する文字列メッセージを取得します。
文字列をAudioTextToSpeechオブジェクトを使用して音声に変換し、音声を再生し、音声が終了するのを待ちます。
デバウンスをfalseに戻します。

デバウンスをfalseからtrueに、コンテキストに応じたTTS音声の再生が終了した後に再びfalseに戻すことは、プレイヤーがボリュームに継続的に衝突する際に音声が繰り返しトリガーされるのを防ぐデバウンスパターンです。このデバウンスパターンの詳細については、デバウンス - 衝突を検出するを参照してください。

ゲームをプレイテストして、プレイヤーキャラクターがトナカイの周りのボリュームに触れたときにコンテキストに応じたヒントを聞きます。TTS音声は、プレイヤーキャラクターがすでに環境内で見つけたガムドロップの数と色に応じて変化します。