Share via

IAgentCharacterEx::SetSRModeID

  • 아티클

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

HRESULT SetSRModeID(
   BSTR bszModeID  // speech recognition engine ID
);

문자에 대해 설정된 음성 인식 엔진의 모드 ID를 설정합니다.

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

bszModeID

문자에 대한 음성 인식 엔진의 모드 ID 설정입니다.

이 설정은 문자의 음성 입력에 대한 엔진을 설정합니다. 음성 인식 엔진의 모드 ID는 엔진 모드(중괄호 및 대시 형식)를 고유하게 식별하는 음성 공급업체에서 정의한 GUID입니다. 자세한 내용은 Microsoft Speech SDK 설명서를 참조하세요.

문자의 언어 설정과 일치하지 않는 모드 ID를 지정하는 경우 사용자가 Microsoft 에이전트 속성 시트에서 음성 인식을 사용하지 않도록 설정했거나 엔진이 설치되지 않은 경우 이 호출이 실패합니다. 문자에 대한 음성 인식 엔진 모드 ID를 설정하지 않으면 서버는 문자의 언어 설정과 일치하는 ID를 설정합니다(Microsoft Speech API 인터페이스 사용).

에이전트 속성 시트(고급 문자 옵션)에서 음성 입력을 사용하도록 설정하면 이 속성을 설정하면 연결된 엔진(아직 로드되지 않은 경우)이 로드되고 음성 서비스가 시작됩니다. 즉, 수신 대기 키를 사용할 수 있으며 수신 대기 팁을 표시할 수 있습니다. (수신 대기 키 및 수신 팁은 고급 문자 옵션에서도 사용하도록 설정된 경우에만 사용하도록 설정됩니다.) 그러나 음성을 사용하지 않도록 설정할 때 속성을 쿼리하는 경우 서버는 음성 서비스를 시작하지 않습니다.

이 속성은 문자의 클라이언트에만 적용됩니다. 설정은 클라이언트의 문자 또는 다른 문자의 다른 클라이언트에 대한 설정을 반영하지 않습니다.

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

참고 항목

IAgentCharacterEx::GetSRModeID