> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Cognitive Services

> OSS プラグインを介して Unreal Engine プロジェクトで音声テキスト変換、テキスト読み上げ、および翻訳のために PlayFab Party Cognitive Services を使用する方法を学びます。

# Cognitive Services の概要

PlayFab Party Cognitive Services インターフェイスには、PlayFab Party によって提供されるアクセシビリティ機能を構成および使用できるようにする関数が含まれています。

これらの機能には次のものが含まれます:

* リアルタイム テキスト チャット翻訳
* リアルタイム音声チャット文字起こし
* リアルタイム音声チャット文字起こしの翻訳
* テキスト読み上げ音声合成

## 料金

Cognitive Services およびコア VOIP とゲーム ネットワーキング機能を超えるその他のサービスには、関連するコストが発生する場合があります。詳細については、[PlayFab Party の請求](https://devdocs.xbox.com/ja-jp/services/playfab/pricing/meters/meters.md#party) ページを参照するか、Microsoft の担当者にお問い合わせください。

## Cognitive Services インターフェイスの使用

ゲームで Cognitive Services インターフェイスを使用するには、次のコード ブロックをゲームの Build.cs ファイルに追加します。

```csharp theme={null}
if (Target.bGenerateProjectFiles || (Target.Type != TargetType.Game && Target.Type != TargetType.Client))
{
	PublicDefinitions.Add("WITH_OSS_PLAYFAB_COGNITIVESERVICES=0");
}
else
{
	PublicDefinitions.Add("WITH_OSS_PLAYFAB_COGNITIVESERVICES=1");

	PublicDependencyModuleNames.Add("OnlineSubsystemPlayFab");
	PrivateDependencyModuleNames.Add("HTTP");
}
```

さらに、Cognitive Services を使用しないプラットフォームでのコンパイル エラーを防ぐために、任意のゲーム コードを **#if WITH\_OSS\_PLAYFAB\_COGNITIVESERVICES** でラップできます。

## SetTextChatTranslationOptions

SetTextChatTranslationOptions を使用すると、チャット翻訳のオン/オフを切り替えることができます。

## SetVoiceChatTranscriptionOptions

SetVoiceChatTranscriptionOptions は、音声文字起こしを有効化および構成するために必要です。

* **bTranscribeSelf** - ローカル チャット コントロールの文字起こしが生成され、同じローカル チャット コントロールに提供されます
* **bTranscribeOtherChatControlsWithMatchingLanguages** - ローカル チャット コントロールと同じ言語を持つ他のチャット コントロールの文字起こしが生成され、ローカル チャット コントロールに提供されます
* **bTranscribeOtherChatControlsWithNonMatchingLanguages** - ローカル チャット コントロールの言語と異なる言語を持つ他のチャット コントロールの文字起こしが生成され、ローカル チャット コントロールに提供されます
* **bTranslateToLocalLanguage** - 文字起こしはローカル チャット コントロールの言語に翻訳されます

## SetTextToSpeechOptions

SetTextToSpeechOptions は、テキスト読み上げを有効化および構成するために必要です。

* **ETextToSpeechType::Narration** - ローカル チャット コントロールのオーディオ出力にオーディオをレンダリングします
* **ETextToSpeechType::VoiceChat** - ローカル チャット コントロールがオーディオを送信するように構成されているチャット コントロールにオーディオをレンダリングします

## SendTextAsVoice

PlayFab Party ネットワークに接続されている他のすべてのクライアントに送信されるテキスト読み上げオーディオを生成します。
**SendTextAsVoice** を呼び出す前に、**SetTextToSpeechOptions** の呼び出しを介して Text as Voice を有効にする必要があります

## SendChatText

PlayFab Party ネットワークに接続されている他のすべてのクライアントにチャット テキスト文字列を送信します。


## Related topics

- [PlayFab Party Unity プラグイン リリース ノート](https://devdocs.xbox.com/ja-jp/services/playfab/multiplayer/networking/party-unity-release-notes.md)
- [Integrate Party with Lobby using Multiplayer SDK](https://devdocs.xbox.com/ja-jp/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [Using direct peer-to-peer connections](https://devdocs.xbox.com/ja-jp/services/playfab/multiplayer/networking/concepts-direct-peer-connectivity.md)
- [Using older versions of Unreal Engine 4](https://devdocs.xbox.com/ja-jp/services/playfab/multiplayer/networking/party-unreal-engine-using-older-versions.md)
- [Using multiple PlayFab Party networks](https://devdocs.xbox.com/ja-jp/services/playfab/multiplayer/networking/concepts-multiple-networks.md)