메인 콘텐츠로 건너뛰기
지정된 유형의 텍스트 음성 변환 작업에 사용할 프로필을 구성합니다.

Syntax

Parameters

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

Return value

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

Remarks

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

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

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

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

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

Requirements

Header: Party.h

See also

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile
마지막 수정일 2026년 10월 20일