Evento Command

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

Descrição

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

Sintaxe

Subagent_Command(ByValUserInput**)**

Parte

Descrição

UserInput

Identifica o objeto Command retornado pelo servidor. As propriedades a seguir podem ser acessadas 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 para o 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 para o próximo (segundo) melhor comando. Alt1Voice Um valor de cadeia de caracteres que identifica o texto de voz para a próxima melhor correspondência de comando alternativa. Alt2Name Um valor de cadeia de caracteres que identifica o nome da terceira melhor correspondência de comando. Alt2Confidence Um inteiro Long que identifica a pontuação de confiança para a terceira melhor correspondência de comando. Alt2Voice Um valor de cadeia de caracteres que identifica o texto de voz para a 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 na 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 possíveis correspondentes em Contagem , bem como o nome, a pontuação de confiança e o texto de voz dessas 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 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 do servidor. Se o comando tiver sido 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. Os parâmetros Confidence, Alt1Confidence e Alt2Confidence retornam as pontuações relativas, no intervalo de -100 a 100, retornadas pelo mecanismo de reconhecimento de fala para cada correspondência respectiva. Os parâmetros Voice, Alt1Voice e Alt2Voice retornam o texto de voz correspondente ao mecanismo de reconhecimento de fala para cada alternativa. Se Count retornar zero (0), o servidor detectou entrada falada, mas determinou que não havia nenhum comando correspondente.

Se a entrada de voz não for a origem do comando, por exemplo, se o usuário tiver selecionado 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 de Voz 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. Verifique com o fornecedor do mecanismo para determinar se o mecanismo dá suporte à interface da API de Fala da Microsoft para retornar alternativas e pontuações de confiança.