Поделиться через

IAgentCharacterEx::SetSRModeID

  • Статья

[Агент Майкрософт не рекомендуется использовать в Windows 7 и может быть недоступен в последующих версиях Windows.]

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

Задает идентификатор режима обработчика распознавания речи, заданного для символа.

  • Возвращает S_OK для указания успешной операции.

bszModeID

Параметр идентификатора режима обработчика распознавания речи для символа.

Этот параметр задает подсистему для голосового ввода символа. Идентификатор режима для подсистемы распознавания речи — это GUID, определенный поставщиком речи, который уникально идентифицирует режим подсистемы (в формате с фигурными скобками и дефисами). Дополнительные сведения см. в документации по пакету SDK службы "Речь Майкрософт".

Если вы укажете идентификатор режима, который не соответствует языковым параметрам символа, если пользователь отключил распознавание речи (на странице свойств Microsoft Agent) или подсистема не установлена, этот вызов завершится ошибкой. Если вы не задали идентификатор режима обработчика распознавания речи для символа, сервер устанавливает тот, который соответствует языковым параметрам символа (с помощью интерфейсов API распознавания речи Майкрософт).

Если речевой ввод включен на странице свойств агента (дополнительные параметры символов), установка этого свойства загрузит связанный модуль (если он еще не загружен) и запустит службы распознавания речи. Это значит, что доступна клавиша прослушивания и отображается подсказка прослушивания. (Клавиша прослушивания и подсказка прослушивания включены только в том случае, если они также включены в расширенных параметрах символов.) Однако при запросе свойства при отключении речи сервер не запускает службы распознавания речи.

Это свойство применяется только к клиенту символа; параметр не отражает параметр для других клиентов символа или других символов клиента.

Требования к подсистеме распознавания речи Microsoft Agent основаны на API службы "Речь Майкрософт". Подсистемы, поддерживающие требования MICROSOFT Agent к SAPI, можно установить и использовать с агентом.

См. также:

IAgentCharacterEx::GetSRModeID