PartyLocalChatControl::SetTextToSpeechProfile

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

구문

PartyError SetTextToSpeechProfile(  
    PartySynthesizeTextToSpeechType type,  
    PartyString profileIdentifier,  
    void* asyncIdentifier  
)  

매개 변수

typePartySynthesizeTextToSpeechType

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

profileIdentifierPartyString

지정된 형식의 텍스트 음성 변환 작업에서 사용할 프로필의 식별자입니다.

asyncIdentifier void*
선택 사항

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

반환 값

PartyError

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

비고

제공된 프로필은 type에 대해 동일한 값을 지정하는 모든 후속 SynthesizeTextToSpeech() 호출에 사용됩니다. SetTextToSpeechProfile()이 한 번 이상 호출될 때까지 프로필이 구성되지 않습니다. 따라서 SynthesizeTextToSpeech() 호출이 성공하려면 이 메서드를 한 번 이상 호출해야 합니다.

이 메서드는 타이틀이 PartyTextToSpeechProfile::GetIdentifier() 결과를 전달하거나 이전 파티 라이브러리 세션에서 캐시된 프로필 식별자를 제공할 수 있도록 프로필 선택을 나타내는 프로필 식별자를 허용합니다.

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

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

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

요구 사항

헤더: Party.h

참고 항목

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile