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

Syntax

Parameters

type   PartySynthesizeTextToSpeechType 지정된 프로필을 사용해야 하는 텍스트-음성 변환 작업의 유형입니다. profileIdentifier   PartyString 지정된 유형의 텍스트-음성 변환 작업이 사용해야 하는 프로필의 식별자입니다. asyncIdentifier   void*
선택 사항
완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적, 앱 정의, 포인터 크기의 컨텍스트 값입니다.

Return value

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

Remarks

제공된 프로필은 동일한 type 값을 지정하는 이후의 모든 SynthesizeTextToSpeech() 호출에 사용됩니다. SetTextToSpeechProfile()이 최소 한 번 호출되기 전에는 프로필이 구성되지 않습니다. 따라서 SynthesizeTextToSpeech() 호출이 성공하기 전에 이 메서드를 최소 한 번 호출해야 합니다.

이 메서드는 프로필 선택을 나타내기 위해 프로필 식별자를 허용하므로, 타이틀은 PartyTextToSpeechProfile::GetIdentifier()의 결과를 전달하거나 이전 Party 라이브러리 세션에서 캐시된 프로필 식별자를 제공할 수 있습니다.

여러 SetTextToSpeechProfile() 작업을 시작할 수 있으며 비동기적으로 큐에 저장됩니다. 각 작업은 순서대로 처리되고 완료됩니다.

이것은 비동기 작업입니다. 완료 시 PartySetTextToSpeechProfileCompletedStateChangePartyManager::StartProcessingStateChanges()를 통해 제공됩니다.

텍스트-음성 변환 합성 기능은 서비스 사용을 최적화하기 위해 내부적으로 사용 가능한 지역 및 지연 시간 측정 예상치를 사용합니다. PartyOption::RegionUpdateConfiguration 옵션을 사용하여 업데이트 모드를 PartyRegionUpdateMode::Deferred로 구성한 경우, 사용 가능한 지역 집합을 검색하고 해당 연결 품질을 측정하는 작업이 아직 시작되지 않았거나 마지막 업데이트가 구성된 새로 고침 간격 수명을 초과했을 수 있습니다. 로컬 디바이스가 현재 네트워크에 연결하고 있지 않거나 연결되어 있지 않은 경우, SetTextToSpeechProfile()은 지연된 지역 업데이트가 시작되었으며 관련 PartyRegionsChangedStateChange가 이 호출의 PartySetTextToSpeechProfileCompletedStateChange 완료 이전에 제공됨을 보장합니다.

Requirements

Header: Party.h

See also

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile
마지막 수정일 2026년 8월 13일