IAgentCharacterEx::SetTTSModeID

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

HRESULT SetTTSModeID(
   BSTR bszModeID  // TTS engine ID
);

문자에 대해 설정된 TTS 엔진의 모드 ID를 설정합니다.

• 작업이 성공했음을 나타내는 S_OK 반환합니다.

bszModeID

문자에 대한 TTS 엔진의 모드 ID 설정입니다.

참고

Speech.dll 설치되어 있지 않고 지정한 엔진이 문자의 컴파일된 TTS 모드 설정과 일치하지 않으면 IAgentCharacterEx:SetTTSModeID가 실패할 수 있습니다.

 

이 설정은 문자의 음성 TTS 출력에 대한 기본 엔진 모드를 결정합니다. TTS(텍스트 음성 변환) 엔진의 모드 ID는 엔진 모드(중괄호 및 대시로 서식 지정됨)를 고유하게 식별하는 음성 공급업체에서 정의한 GUID입니다. 자세한 내용은 Microsoft Speech SDK 설명서를 참조하세요.

TTS 모드 ID를 설정하면 서버에서 문자의 컴파일된 TTS 모드 ID, 현재 시스템 언어 ID 및 문자의 현재 언어 ID에 따라 음성 엔진을 일치시키려는 시도를 재정의합니다. 그러나 사용자가 Microsoft 에이전트 속성 시트에서 음성 출력을 사용하지 않도록 설정했거나 연결된 엔진이 설치되지 않은 경우 모드 ID를 설정하려고 하면 이 호출이 실패합니다.

문자에 대한 TTS 엔진 모드 ID를 설정하지 않으면 서버는 문자의 언어 설정과 일치하는 엔진을 설정합니다(Microsoft Speech API 인터페이스 사용). 이 속성을 설정하면 연결된 엔진이 아직 로드되지 않은 경우 해당 엔진이 로드됩니다.

이 속성은 클라이언트 애플리케이션의 문자 사용에만 적용됩니다. 설정은 클라이언트 애플리케이션의 문자 또는 다른 문자의 다른 클라이언트에 영향을 주지 않습니다.

Microsoft 에이전트의 음성 엔진 요구 사항은 Microsoft Speech API를 기반으로 합니다. Microsoft 에이전트의 SAPI 요구 사항을 지원하는 엔진을 설치하고 에이전트와 함께 사용할 수 있습니다.

참고 항목

IAgentCharacterEx:GetTTSModeID