Метод Listen

[Microsoft Agent является нерекомендуемым начиная с Windows 7 и может быть недоступен в последующих версиях Windows.]

Описание

Включает режим прослушивания (распознавание речи) на период времени.

Синтаксис

Агент. Символов ("CharacterID"). Состояние прослушивания**

Часть	Описание
Состояние	Обязательный. Логическое значение, определяющее, следует ли включать или выключать режим прослушивания. Истинный Включает режим прослушивания. Ложных Выключает режим прослушивания.

Комментарии

Установка для этого метода значения True включает режим прослушивания (включает распознавание речи) на фиксированный период времени (10 секунд). Хотя вы не можете задать значение времени ожидания, вы можете отключить режим прослушивания до истечения времени ожидания. Если вы (или другой клиент) успешно настроили режим прослушивания и попытаелись установить для этого свойства значение True до истечения времени ожидания, метод завершится успешно и сбросит время ожидания. Однако если режим прослушивания включен, так как пользователь нажимает клавишу listening, метод завершается успешно, но время ожидания игнорируется и режим прослушивания завершается в зависимости от взаимодействия пользователя с клавишей прослушивания.

Этот метод выполняется успешно, только если клиент вызывает активный входные данные и запущены службы распознавания речи. Чтобы убедиться, что службы распознавания речи запущены, запросите или задайте SRModeID или задайте параметр Голосовой связи для команды перед вызовом прослушивания , в противном случае метод завершится ошибкой. Чтобы определить успешность этого метода, вызовите его как функцию, и он вернет логическое значение, указывающее, успешно ли выполнен метод.

   If Genie.Listen(True) Then
      'The method succeeded

   Else
      ' The method failed

   End If

Метод также завершается ошибкой, если пользователь нажимает клавишу Listening и вы пытаетесь установить значение Прослушивание false. Однако если пользователь отпустил ключ прослушивания и время ожидания в режиме прослушивания не истекло, он будет выполнен успешно.

Прослушивание также завершается ошибкой, если отсутствует совместимый речевой модуль, соответствующий параметру LanguageID символа, пользователь отключил речевой ввод с помощью страницы свойств Агента Майкрософт или звуковое устройство занято.

После успешного задания для этого метода значения True сервер активирует событие ListenStart . Сервер отправляет ListenComplete, когда истекло время ожидания режима прослушивания или если задано значение False.

Этот метод не вызывает автоматически stop и не воспроизводит анимацию состояния прослушивания, как это делает сервер при нажатии клавиши Listening. Это позволяет определить, следует ли прервать текущую анимацию с помощью анимации ListenStart , вызвав Stop и включив соответствующую анимацию. Однако сервер вызывает stop и воспроизводит анимацию состояния слушания при обнаружении пользовательского высказывания.

См. также:

Свойство LanguageID, событие ListenComplete, событие ListenStart