> ## 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.

# XSpeechSynthesizer

> XSpeechSynthesizer

# XSpeechSynthesizer

텍스트 문자열을 오디오 스트림으로 변환하기 위한 음성 합성 엔진(*음성*)의 초기화 및 구성 지원을 제공합니다. 이 기능은 TTS(텍스트 음성 변환)라고도 합니다.

## 함수

| 함수                                                                                                                                      | 설명                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [XSpeechSynthesizerCloseHandle](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerclosehandle)                           | 음성 합성기를 닫고 할당된 시스템 리소스를 해제합니다.                                                                                                                                                  |
| [XSpeechSynthesizerCloseStreamHandle](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerclosestreamhandle)               | 음성 합성기 스트림을 닫고 할당된 시스템 리소스를 해제합니다.                                                                                                                                              |
| [XSpeechSynthesizerCreate](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreate)                                     | 음성 합성기를 만듭니다.                                                                                                                                                                   |
| [XSpeechSynthesizerCreateStreamFromSsml](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreatestreamfromssml)         | 지정된 SSML로부터 음성 합성 스트림을 만듭니다.                                                                                                                                                    |
| [XSpeechSynthesizerCreateStreamFromText](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreatestreamfromtext)         | 지정된 일반 텍스트로부터 음성 합성 스트림을 만듭니다.                                                                                                                                                  |
| [XSpeechSynthesizerEnumerateInstalledVoices](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices) | 설치된 음성을 열거하고 각 음성에 대해 *callback*이 가리키는 메서드를 호출합니다.                                                                                                                              |
| [XSpeechSynthesizerGetStreamData](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizergetstreamdata)                       | 음성 합성 스트림에서 데이터를 검색합니다.                                                                                                                                                         |
| [XSpeechSynthesizerGetStreamDataSize](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizergetstreamdatasize)               | 음성 합성 스트림에서 데이터 버퍼의 크기를 가져옵니다.                                                                                                                                                  |
| [XSpeechSynthesizerInstalledVoicesCallback](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerinstalledvoicescallback)   | [XSpeechSynthesizerEnumerateInstalledVoices](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerenumerateinstalledvoices)가 호출될 때 음성에 대한 정보를 받는 클라이언트 구현 콜백 함수입니다. |
| [XSpeechSynthesizerSetCustomVoice](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizersetcustomvoice)                     | 음성 합성기가 지정된 사용자 지정 음성을 사용하도록 지정합니다.                                                                                                                                             |
| [XSpeechSynthesizerSetDefaultVoice](/reference/system/xspeechsynthesizer/functions/xspeechsynthesizersetdefaultvoice)                   | 음성 합성기가 시스템의 기본 음성을 사용하도록 지정합니다.                                                                                                                                                |

## 구조체

| 구조체                                                                                                                   | 설명                |
| --------------------------------------------------------------------------------------------------------------------- | ----------------- |
| [XSpeechSynthesizerVoiceInformation](/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation) | 음성에 대한 정보를 제공합니다. |

## 열거형

| 열거형                                                                                                       | 설명             |
| --------------------------------------------------------------------------------------------------------- | -------------- |
| [XSpeechSynthesizerVoiceGender](/reference/system/xspeechsynthesizer/enums/xspeechsynthesizervoicegender) | 음성의 성별을 나타냅니다. |

## 개념 설명서

* [Text-to-speech](/build/console-features/text-to-speech/text-to-speech)
* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Using C# wrappers for GDK APIs in your Unity project](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/get-started-with-unity-pc/features/gdk-unity-api-wrappers)

## 참고 항목

[시스템 API 참조](/reference/system/gc-reference-system-toc)


## Related topics

- [XSpeechSynthesizerCreate](/ko/reference/system/xspeechsynthesizer/functions/xspeechsynthesizercreate.md)
- [XSpeechSynthesizerVoiceGender](/ko/reference/system/xspeechsynthesizer/enums/xspeechsynthesizervoicegender.md)
- [XSpeechSynthesizerCloseHandle](/ko/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerclosehandle.md)
- [XSpeechSynthesizerVoiceInformation](/ko/reference/system/xspeechsynthesizer/structs/xspeechsynthesizervoiceinformation.md)
- [XSpeechSynthesizerCloseStreamHandle](/ko/reference/system/xspeechsynthesizer/functions/xspeechsynthesizerclosestreamhandle.md)