Evento de comando

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

Descrição

Ocorre quando o usuário escolhe um comando (do cliente).

Sintaxe

Subagent_Command(ByValUserInput**)**

Peça

Descrição

UserInput

Identifica o Command objeto retornado pelo servidor. As seguintes propriedades podem ser acessadas a partir do Command objeto: ID do personagem Um valor de cadeia de caracteres que identifica o nome (ID) do caractere que recebeu o comando. Nome Um valor de cadeia de caracteres que identifica o nome (ID) do comando. Confiança Um valor inteiro longo que indica a pontuação de confiança para o comando. Voz Um valor de cadeia de caracteres que identifica o texto de voz para o comando. Alt1Nome Um valor de cadeia de caracteres que identifica o nome do próximo (segundo) melhor comando. Alt1Confiança Um valor inteiro longo indicando a pontuação de confiança para o próximo (segundo) melhor comando. Alt1Voz Um valor de cadeia de caracteres que identifica o texto de voz para a próxima melhor correspondência de comando alternativo. Alt2Nome Um valor de cadeia de caracteres que identifica o nome da terceira melhor correspondência de comando. Alt2Confiança Um inteiro longo identificando a pontuação de confiança para a terceira melhor partida de comando. Alt2Voz Um valor de cadeia de caracteres que identifica o texto de voz para a terceira melhor correspondência de comando. Contagem Valor inteiro longo indicando o número de alternativas retornadas.

Comentários

O servidor notifica você com esse evento quando seu aplicativo está ativo de entrada e o usuário escolhe um comando por entrada falada ou menu pop-up do caractere. O evento repassa o número de comandos correspondentes possíveis em de contagem, bem como o nome, a pontuação de confiança e o texto de voz para essas correspondências.

Se a entrada de voz acionar esse evento, o servidor retornará uma cadeia de caracteres que identifica a melhor correspondência no parâmetro Name e a segunda e terceira melhor correspondência em Alt1Name e Alt2Name . Uma cadeia de caracteres vazia indica que a entrada não correspondeu a nenhum comando definido pelo aplicativo; por exemplo, pode ser um dos comandos definidos pelo servidor. Se o comando foi correspondido ao comando do Agente; por exemplo, Ocultar, uma cadeia de caracteres vazia seria retornada no parâmetro Name, mas você ainda receberia o texto ouvido no parâmetro Voice.

Você pode obter o mesmo nome de comando retornado em mais de uma entrada. parâmetros Confidence, Alt1Confidence e Alt2Confidence retornam as pontuações relativas, no intervalo de -100 a 100, que são retornadas pelo mecanismo de reconhecimento de fala para cada correspondência respetiva. parâmetros Voice, Alt1Voice e Alt2Voice retornam o texto de voz que o mecanismo de reconhecimento de fala correspondeu para cada alternativa. Se Count retornar zero (0), o servidor detetou a entrada falada, mas determinou que não havia nenhum comando correspondente.

Se a entrada de voz não foi a origem do comando, por exemplo, se o usuário selecionou o comando no menu pop-up do caractere, o servidor retornará o nome (ID) do comando selecionado na propriedade Nome. Ele também retorna o valor do parâmetro Confidence como 100 e o valor dos parâmetros Voice como a cadeia de caracteres vazia (""). Alt1Name e Alt2Name também retornam cadeias de caracteres vazias. Alt1Confidence e Alt2Confidence retornam zero (0) e Alt1Voice e Alt2Voice retornam cadeias vazias. Contagem retorna 1.