> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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://docs.xbox.com/ko/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://docs.xbox.com/ko/services/playfab/multiplayer/networking/party-unity-release-notes.md)
- [Using text moderation](https://docs.xbox.com/ko/services/playfab/community/voice-communications/concepts-text-moderation.md)
- [Using player statistics](https://docs.xbox.com/ko/services/playfab/community/leaderboards/tournaments-leaderboards/using-player-statistics.md)
- [Unreal용 PlayFab Party Online Subsystem](https://docs.xbox.com/ko/build/console-features/networking/game-mesh/party-unreal-online-subsystem.md)
- [빠른 시작 (Windows) - Party 및 Multiplayer](https://docs.xbox.com/ko/services/playfab/sdks/unified-sdk/quickstart-windows-party.md)