TTSModeID 속성
[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]
-
Description
-
문자에 사용되는 TTS 엔진 모드를 반환하거나 설정합니다.
-
Syntax
-
agent**. 문자("CharacterID"). TTSModeID** [ = ModeID]
부분 Description ModeID 음성 엔진의 모드 ID에 해당하는 문자열 식입니다.
설명
이 속성은 문자의 음성 출력에 대한 TTS(텍스트 음성 변환) 엔진 모드 ID를 결정합니다. TTS 엔진의 모드 ID는 엔진 모드를 고유하게 식별하는 음성 공급업체에서 정의한 형식이 지정된 문자열입니다. 자세한 내용은 코드에서 음성 엔진 액세스를 참조하세요.
이 속성을 설정하면 문자의 컴파일된 TTS 설정 및 문자의 현재 LanguageID 설정에 따라 엔진을 로드하려는 서버의 시도가 재정의됩니다. 그러나 설치되지 않은 엔진의 모드 ID를 지정하거나 사용자가 Microsoft 에이전트 속성 시트(AudioOutput.Enabled = False)에서 음성 출력을 사용하지 않도록 설정한 경우 서버에서 오류가 발생합니다.
문자에 대한 TTS 모드 ID를 설정하지 않았거나 설정하지 않은 경우 서버는 문자의 컴파일된 TTS 모드 설정이 문자의 LanguageID 설정과 일치하는지, 연결된 TTS 엔진이 설치되어 있는지 확인합니다. 이 경우 문자가 음성 출력에 사용하는 TTS 모드와 이 속성은 해당 모드 ID를 반환합니다. 그렇지 않은 경우 서버는 문자의 LanguageID 와 일치하는 호환되는 SAPI 음성 엔진과 문자의 컴파일된 모드 ID에 대해 설정된 성별 및 연령을 요청합니다. 문자의 LanguageID를 설정하지 않은 경우 해당 LanguageID 는 현재 사용자 언어입니다. 일치하는 엔진을 찾을 수 없는 경우 이 속성에 대한 쿼리는 엔진의 모드 ID에 대한 빈 문자열을 반환합니다. 마찬가지로 사용자가 Microsoft 에이전트 속성 시트(AudioOutput.Enabled = False)에서 음성 출력을 사용하지 않도록 설정한 경우 이 속성을 쿼리하면 값은 빈 문자열이 됩니다.
이 속성을 쿼리하거나 설정하면 연결된 엔진이 로드됩니다(아직 로드되지 않은 경우). 그러나 문자의 컴파일된 TTS 설정에 지정된 엔진이 설치되어 있고 문자의 언어 ID 설정과 일치하는 경우 문자가 로드될 때 엔진이 로드됩니다.
이 속성은 클라이언트 애플리케이션의 문자 사용에만 적용됩니다. 설정은 클라이언트 애플리케이션의 문자 또는 다른 문자의 다른 클라이언트에 영향을 주지 않습니다.
Microsoft 에이전트의 음성 엔진 요구 사항은 Microsoft Speech API를 기반으로 합니다. Microsoft 에이전트의 SAPI 요구 사항을 지원하는 엔진을 설치하고 에이전트와 함께 사용할 수 있습니다.
참고
또한 이 속성은 시스템에 호환되는 사운드 지원이 설치되어 있지 않은 경우 빈 문자열을 반환합니다.
참고
Speech.dll 설치되지 않고 지정한 엔진이 문자의 컴파일된 TTS 모드 설정과 일치하지 않으면 TTSModeID 설정이 실패할 수 있습니다.
참고
이 속성을 쿼리해도 일반적으로 오류가 반환되지는 않습니다. 그러나 음성 엔진을 로드하는 데 비정상적으로 오랜 시간이 걸리는 경우 쿼리 시간이 초과되었음을 나타내는 오류가 발생할 수 있습니다.
참고 항목