Событие command

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

Описание

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

Синтаксис

Subagent_Command(ByValUserInput**)**

Часть

Описание

Userinput

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

Комментарии

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

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

Вы можете получить одно и то же имя команды, возвращаемое в нескольких записях. Параметры Confidence, Alt1Confidence и Alt2Confidence возвращают относительные оценки в диапазоне от –100 до 100, возвращаемые подсистемой распознавания речи для каждого соответствующего соответствия. Параметры Voice, Alt1Voice и Alt2Voice возвращают голосовый текст, соответствующий механизму распознавания речи для каждой альтернативы. Если функция Count возвращает ноль (0), сервер обнаружил речевой ввод, но определил, что соответствующая команда отсутствует.

Если голосовой ввод не был источником команды, например, если пользователь выбрал команду во всплывающем меню символа, сервер возвращает имя (идентификатор) команды, выбранной в свойстве Name. Он также возвращает значение параметра Confidence в виде 100, а значение параметров Voice — в виде пустой строки (""). Alt1Name и Alt2Name также возвращают пустые строки. Alt1Confidence и Alt2Confidence возвращают ноль (0), а Alt1Voice и Alt2Voice возвращают пустые строки. Счетчик возвращает значение 1.

Примечание

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