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

# PartyLocalChatControl::SetTextToSpeechProfile

> 지정된 유형의 텍스트-음성 변환 작업에 사용할 프로필을 구성합니다.

지정된 유형의 텍스트-음성 변환 작업에 사용할 프로필을 구성합니다.

## Syntax

```cpp theme={null}
PartyError SetTextToSpeechProfile(  
    PartySynthesizeTextToSpeechType type,  
    PartyString profileIdentifier,  
    void* asyncIdentifier  
)  
```

### Parameters

**`type`**   [PartySynthesizeTextToSpeechType](/services/playfab/multiplayer/networking/reference/enums/partysynthesizetexttospeechtype)

지정된 프로필을 사용해야 하는 텍스트-음성 변환 작업의 유형입니다.

**`profileIdentifier`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

지정된 유형의 텍스트-음성 변환 작업이 사용해야 하는 프로필의 식별자입니다.

**`asyncIdentifier`**   void\*\
*선택 사항*

완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적, 앱 정의, 포인터 크기의 컨텍스트 값입니다.

### Return value

PartyError

텍스트-음성 변환 프로필을 설정하기 위한 비동기 작업이 시작된 경우 `c_partyErrorSuccess`, 그렇지 않으면 오류 코드입니다. 이 메서드가 실패하면 관련 상태 변경이 생성되지 않습니다. 오류 코드의 사람이 읽을 수 있는 형식은 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)를 통해 검색할 수 있습니다.

## Remarks

제공된 프로필은 동일한 `type` 값을 지정하는 이후의 모든 [SynthesizeTextToSpeech()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech) 호출에 사용됩니다. SetTextToSpeechProfile()이 최소 한 번 호출되기 전에는 프로필이 구성되지 않습니다. 따라서 SynthesizeTextToSpeech() 호출이 성공하기 전에 이 메서드를 최소 한 번 호출해야 합니다. <br /><br /> 이 메서드는 프로필 선택을 나타내기 위해 프로필 식별자를 허용하므로, 타이틀은 [PartyTextToSpeechProfile::GetIdentifier()](/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/methods/partytexttospeechprofile_getidentifier)의 결과를 전달하거나 이전 Party 라이브러리 세션에서 캐시된 프로필 식별자를 제공할 수 있습니다.   <br /><br /> 여러 SetTextToSpeechProfile() 작업을 시작할 수 있으며 비동기적으로 큐에 저장됩니다. 각 작업은 순서대로 처리되고 완료됩니다.   <br /><br /> 이것은 비동기 작업입니다. 완료 시 [PartySetTextToSpeechProfileCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange)가 [PartyManager::StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges)를 통해 제공됩니다.   <br /><br /> 텍스트-음성 변환 합성 기능은 서비스 사용을 최적화하기 위해 내부적으로 사용 가능한 지역 및 지연 시간 측정 예상치를 사용합니다. [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션을 사용하여 업데이트 모드를 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)로 구성한 경우, 사용 가능한 지역 집합을 검색하고 해당 연결 품질을 측정하는 작업이 아직 시작되지 않았거나 마지막 업데이트가 구성된 새로 고침 간격 수명을 초과했을 수 있습니다. 로컬 디바이스가 현재 네트워크에 연결하고 있지 않거나 연결되어 있지 않은 경우, SetTextToSpeechProfile()은 지연된 지역 업데이트가 시작되었으며 관련 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)가 이 호출의 [PartySetTextToSpeechProfileCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange) 완료 이전에 제공됨을 보장합니다.

## Requirements

**Header:** Party.h

## See also

[PartyLocalChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyLocalChatControl::GetTextToSpeechProfile](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettexttospeechprofile)


## Related topics

- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)
- [PartyLocalChatControl::GetTextToSpeechProfile](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettexttospeechprofile.md)
- [PartyTextToSpeechProfile](/ko/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/partytexttospeechprofile.md)
- [PartyLocalChatControl::SynthesizeTextToSpeech](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech.md)
- [PartySynthesizeTextToSpeechType](/ko/services/playfab/multiplayer/networking/reference/enums/partysynthesizetexttospeechtype.md)