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

Событие команды

  • Статья

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

Description

Происходит при выборе пользователем команды (клиента).

Синтаксис

Subagent_Command(ByValUserInput**)**

Часть Description
UserInput Определяет объект Command, возвращаемый сервером.
Доступ к следующим свойствам можно получить из объекта Command:
Символьный идентификатор
Строковое значение, определяющее имя (идентификатор) символа, полученного командой.
Имя
Строковое значение, определяющее имя (идентификатор) команды.
Достоверность
Длинное целое значение, указывающее оценку достоверности для команды.
Голосовая связь
Строковое значение, определяющее текст голоса для команды.
Alt1Name
Строковое значение, определяющее имя следующей (второй) лучшей команды.
Alt1Confidence
Длинное целое значение, указывающее оценку достоверности для следующей (второй) лучшей команды.
Alt1Voice
Строковое значение, определяющее текст голосовой связи для следующего оптимального альтернативного совпадения команд.
Alt2Name
Строковое значение, определяющее имя третьего лучшего совпадения команд.
Alt2Confidence
Длинное целое число, определяющее достоверность оценки за третий лучший матч команды.
Alt2Voice
Строковое значение, определяющее текст голоса для третьего лучшего совпадения команд.
Численность
Длинное целое значение, указывающее количество возвращаемых альтернатив.

Замечания

Сервер уведомляет вас об этом событии, когда приложение входящее и активно, а пользователь выбирает команду, используя голосовое или всплывающее меню символа. Событие передает обратно количество возможных команд сопоставления в Count , а также имя, оценка достоверности и голосовый текст для этих совпадений.

Если входные данные голоса активируют это событие, сервер возвращает строку, которая определяет лучшее совпадение в параметре Name , а второй и третий лучший матч в ALT1Name и ALT2Name. Пустая строка указывает, что входные данные не соответствовали какой-либо команде, определенной приложением; Например, это может быть одна из определенных команд сервера. Если команда была сопоставлена с командой агента; Например, скрытие, пустая строка будет возвращена в параметре Name, но вы по-прежнему получите текст, услышанный в параметре голосовой связи.

Вы можете получить одно и то же имя команды, возвращенное в нескольких записях. Достоверность, alt1Confidence и параметры ALT2Confidence возвращают относительные оценки в диапазоне от -100 до 100, которые возвращаются подсистемой распознавания речи для каждого соответствующего соответствия. Параметры Voice, ALT1Voice и ALT2Voice возвращают голосовый текст, соответствующий механизму распознавания речи для каждой альтернативы. Если число возвращает ноль (0), сервер обнаружил реченные входные данные, но определил, что не было соответствующей команды.

Если входные данные голоса не были источником для команды, например, если пользователь выбрал команду из всплывающего меню символа, сервер возвращает имя (идентификатор) команды, выбранной в свойстве Name. Он также возвращает значение параметра Достоверности как 100, а значение параметров голоса — пустой строкой (""). Alt1Name и ALT2Name также возвращают пустые строки. Alt1Confidence и ALT2Confidence возвращают ноль (0), а ALT1Voice и ALT2Voice возвращают пустые строки. Счетчик возвращает значение 1.

Примечание.

Не все подсистемы распознавания речи могут возвращать все значения для всех параметров этого события. Обратитесь к поставщику обработчика, чтобы определить, поддерживает ли модуль интерфейс API службы "Речь Майкрософт" для возврата альтернативных вариантов и оценки достоверности.