Compartir a través de

Evento Command

  • Artículo

[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).

Sintaxis

Sub agent_Command (ByVal UserInput**)**

Parte Descripción
UserInput Identifica el objeto Command devuelto por el servidor.
Se puede tener acceso a las siguientes propiedades en el objeto Command:
CharacterID
Valor de cadena que identifica el nombre (ID) del personaje que recibió el comando.
Nombre
Valor de cadena que identifica el nombre (ID) del comando.
Confianza
Valor de entero largo 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 siguiente (segundo) mejor comando.
Alt1Confidence
Valor de entero largo que indica la puntuación de confianza del siguiente mejor comando (segundo).
Alt1Voice
Valor de cadena que identifica el texto de voz para la siguiente mejor coincidencia alternativa de comando.
Alt2Name
Valor de cadena que identifica el nombre de la tercera mejor coincidencia de comando.
Alt2Confidence
Entero largo que identifica la puntuación de confianza para la tercera mejor coincidencia de comando.
Alt2Voice
Valor de cadena que identifica el texto de voz para la tercer mejor coincidencia de comando.
Recuento
Valor de entero largo que indica el número de alternativas devueltas.

Comentarios

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

Si la entrada de voz activa 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 coincide con el comando del Agente; por ejemplo, Hide (Ocultar), se devolvería una cadena vacía en el parámetro Name, pero aun así recibiría el texto escuchado en el parámetro Voice.

Se puede recibir el mismo nombre de comando devuelto en más de una entrada. Los parámetros Confidence, Alt1Confidence y Alt2Confidence devuelven las puntuaciones relativas, en un intervalo de -100 a 100, que devuelve el motor de reconocimiento de voz en cada coincidencia respectiva. Los parámetros Voice, Alt1Voice y Alt2Voice devuelven el texto de voz que el motor de reconocimiento de voz encontró como coincidencia en cada alternativa. Si Count devuelve cero (0), el servidor detecta la entrada expresada, pero determina 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 personaje, el servidor devolverá el nombre (ID) del comando seleccionado en la propiedad Name. Además, devuelve el valor del parámetro Confidence como 100 y el valor de los parámetros Voice como 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. Consulte al proveedor del motor para determinar si el motor admite la interfaz de Microsoft Speech API para devolver alternativas y puntuaciones de confianza.