Command (evento)

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.

Descripción

Se produce cuando el usuario elige un comando (cliente).

Syntax

Subagent_Command(ByValUserInput**)**

Parte

Descripción

UserInput

Identifica el objeto Command devuelto por el servidor. Se puede tener acceso a las siguientes propiedades desde el objeto Command : CharacterID Valor de cadena que identifica el nombre (ID) del carácter que recibió el comando. Nombre Valor de cadena que identifica el nombre (ID) del comando. Confianza Valor entero long que indica la puntuación de confianza del comando. Voz Valor de cadena que identifica el texto de voz del comando. Alt1Name Valor de cadena que identifica el nombre del comando siguiente (segundo) mejor. Alt1Confidence Valor entero long que indica la puntuación de confianza para el siguiente comando (segundo) mejor. Alt1Voice Valor de cadena que identifica el texto de voz para la siguiente mejor coincidencia de comandos alternativo. Alt2Name Valor de cadena que identifica el nombre de la tercera coincidencia de comandos mejor. Alt2Confidence Entero largo que identifica la puntuación de confianza para la tercera mejor coincidencia de comandos. Alt2Voice Valor de cadena que identifica el texto de voz para la tercera mejor coincidencia de comandos. Count Valor entero largo que indica el número de alternativas devueltas.

Observaciones

El servidor le notifica a este evento cuando la aplicación está activa de entrada y el usuario elige un comando por entrada hablada o menú emergente del carácter. El evento devuelve el número de posibles comandos coincidentes en Count , así como el nombre, la puntuación de confianza y el texto de voz de esas coincidencias.

Si la entrada de voz desencadena este evento, el servidor devuelve una cadena que identifica la mejor coincidencia en el parámetro Name y la segunda y la tercera mejor coincidencia en Alt1Name y Alt2Name . Una cadena vacía indica que la entrada no coincide con ningún comando definido por la aplicación; por ejemplo, podría ser uno de los comandos definidos por el servidor. Si el comando se ha emparejado con el comando del Agente; por ejemplo, Ocultar, se devolvería una cadena vacía en el parámetro Name , pero todavía recibiría el texto escuchado en el parámetro Voice .

Puede obtener el mismo nombre de comando devuelto en más de una entrada. Los parámetros Confidence, Alt1Confidence y Alt2Confidence devuelven las puntuaciones relativas, en el intervalo de -100 a 100, que devuelve el motor de reconocimiento de voz para cada coincidencia respectiva. Los parámetros Voice, Alt1Voice y Alt2Voice devuelven el texto de voz que el motor de reconocimiento de voz coincide con cada alternativa. Si Count devuelve cero (0), el servidor detectó la entrada hablada, pero determinó que no había ningún comando coincidente.

Si la entrada de voz no era el origen del comando, por ejemplo, si el usuario seleccionó el comando en el menú emergente del carácter, el servidor devuelve el nombre (ID) del comando seleccionado en la propiedad Name. También devuelve el valor del parámetro Confidence como 100 y el valor de los parámetros Voice como la cadena vacía (""). Alt1Name y Alt2Name también devuelven cadenas vacías. Alt1Confidence y Alt2Confidence devuelven cero (0) y Alt1Voice y Alt2Voice devuelven cadenas vacías. Count devuelve 1.

Nota

No todos los motores de reconocimiento de voz pueden devolver todos los valores de todos los parámetros de este evento. Póngase en contacto con el proveedor del motor para determinar si el motor admite la interfaz de Microsoft Speech API para devolver alternativas y puntuaciones de confianza.