Evento de comando

[O Microsoft Agent foi preterido do Windows 7 em diante 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

Sub agent_Command (ByVal UserInput**)**

Parte

Descrição

UserInput

Identifica o objeto Command retornado pelo servidor. As seguintes propriedades podem ser acessadas por meio do objeto Command: CharacterID 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 do comando. Voz Um valor de cadeia de caracteres que identifica o texto de voz do comando. Alt1Name Um valor de cadeia de caracteres que identifica o nome do próximo (segundo) melhor comando. Alt1Confidence Um valor inteiro longo que indica a pontuação de confiança do próximo (segundo) melhor comando. Alt1Voice Um valor de cadeia de caracteres que identifica o texto de voz da próxima melhor correspondência de comando alternativo. Alt2Name Um valor de cadeia de caracteres que identifica o nome da terceira melhor correspondência de comando. Alt2Confidence Um inteiro longo que identifica a pontuação de confiança da terceira melhor correspondência de comando. Alt2Voice Um valor de cadeia de caracteres que identifica o texto de voz da terceira melhor correspondência de comando. Count Valor inteiro longo que indica o número de alternativas retornadas.

Comentários

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

Se a entrada de voz disparar esse evento, o servidor retornará uma cadeia de caracteres que identifica a melhor correspondência no parâmetro Name, bem como a segunda e a terceira melhores correspondências 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 do servidor. Se o comando tiver correspondido ao comando do Agente, por exemplo, Hide, uma cadeia de caracteres vazia será 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. Os 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 respectiva correspondência. Os parâmetros Voice, Alt1Voice e Alt2Voice retornam o texto de voz que o mecanismo de reconhecimento de fala correspondeu para cada alternativa. Caso Count retorne zero (0), significa que o servidor detectou a entrada falada, mas determinou que não há comando correspondente.

Se a entrada de voz não for 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 Name. 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 de caracteres vazias. Count retorna 1.

Observação

Nem todos os mecanismos de reconhecimento de fala podem retornar todos os valores para todos os parâmetros desse evento. Determine em parceria com o fornecedor do mecanismo se o mecanismo dá suporte à interface da Microsoft Speech API para retornar alternativas e pontuações de confiança.