IAgentCharacterEx::GetTTSModeID

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

HRESULT GetTTSModeID(
   BSTR * pbszModeID  // address of TTS engine ID
);

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

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

pbszModeID

문자에 대한 TTS 엔진의 모드 ID 설정을 수신하는 BSTR의 주소입니다.

이 설정은 문자의 음성 출력에 대한 TTS(텍스트 음성 변환) 엔진 모드 ID를 반환합니다. TTS 엔진의 모드 ID는 엔진을 고유하게 식별하는 음성 공급업체에서 정의한 GUID(중괄호 및 대시 형식)의 문자열 표현입니다. 자세한 내용은 Microsoft Speech SDK 설명서를 참조하세요. 이 속성을 쿼리하면 연결된 엔진이 아직 로드되지 않은 경우 로드됩니다.

문자에 대한 TTS 엔진 모드 ID를 설정하지 않으면 서버는 문자의 컴파일된 TTS 설정 및 문자의 현재 언어 설정과 일치하는 엔진을 반환하려고 시도합니다(Microsoft Speech API 인터페이스 사용). 이러한 설정이 다른 경우 문자의 언어 설정이 작성된 모드 설정을 재정의합니다. 문자의 언어 설정을 설정하지 않은 경우 문자의 언어는 사용자 기본 언어 ID이며 서버는 해당 언어 ID에 따라 일치를 시도합니다.

IAgentAudioObjectProperties::GetEnabled가 False를 반환하는 경우 이 함수는 실패하지 않습니다.

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

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

참고 항목

IAgentCharacterEx::SetTTSModeID