IntentRecognizer Classe

Pacote:

com.microsoft.cognitiveservices.speech.intent

Artefato Maven:

com.microsoft.cognitiveservices.speech:client-sdk:1.38.0

• java.lang.Object
• • com.microsoft.cognitiveservices.speech.Recognizer
  • • com.microsoft.cognitiveservices.speech.intent.IntentRecognizer

public final class IntentRecognizer
extends Recognizer

Executa o reconhecimento de intenção na entrada de fala. Ele retorna texto reconhecido e intenção reconhecida. Observação: close() deve ser chamado para liberar recursos subjacentes mantidos pelo objeto .

Resumo do campo

Modificador e tipo	Campo e descrição
final EventHandlerImpl<IntentRecognitionCanceledEventArgs>	canceled O evento cancelado sinaliza que o reconhecimento de intenção foi cancelado.
final EventHandlerImpl<IntentRecognitionEventArgs>	recognized O evento reconhecido sinaliza que um resultado de reconhecimento final é recebido.
final EventHandlerImpl<IntentRecognitionEventArgs>	recognizing O evento reconhecendo sinais de que um resultado de reconhecimento intermediário é recebido.

Resumo do Construtor

Construtor	Description
IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig)	Cria uma nova instância de um reconhecedor de intenção com a configuração de fala inserida.
IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig, AudioConfig audioConfig)	Cria uma nova instância de um reconhecedor de intenção com a configuração de fala inserida.
IntentRecognizer(SpeechConfig speechConfig)	Cria uma nova instância de um reconhecedor de intenção.
IntentRecognizer(SpeechConfig speechConfig, AudioConfig audioConfig)	Cria uma nova instância de um reconhecedor de intenção.

Resumo do método

Modificador e tipo	Método e descrição
void	addAllIntents(LanguageUnderstandingModel model) Adiciona todas as intenções do modelo de Reconhecimento vocal especificado.
void	addAllIntents(LanguageUnderstandingModel model, String intentId) Adiciona todas as intenções do modelo de Reconhecimento vocal especificado.
void	addIntent(LanguageUnderstandingModel model, String intentName) Adiciona uma única intenção por nome do modelo de Reconhecimento vocal especificado.
void	addIntent(LanguageUnderstandingModel model, String intentName, String intentId) Adiciona uma única intenção por nome do modelo de Reconhecimento vocal especificado.
void	addIntent(String simplePhrase) Adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica.
void	addIntent(String simplePhrase, String intentId) Adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica.
boolean	applyLanguageModels(Collection<LanguageUnderstandingModel> collection) Usa uma coleção de modelos de reconhecimento vocal, faz uma cópia deles e os aplica ao reconhecedor.
protected void	dispose(boolean disposing) Esse método executa a limpeza de recursos.
java.lang.String	getAuthorizationToken() Obtém o token de autorização usado para se comunicar com o serviço.
PropertyCollection	getProperties() A coleção de propriedades e seus valores definidos para este Reconhecimento de Intenção.
java.lang.String	getSpeechRecognitionLanguage() Obtém a linguagem falada de reconhecimento.
java.util.concurrent.Future<IntentRecognitionResult>	recognizeOnceAsync() Inicia o reconhecimento de intenção e retorna depois que um único enunciado é reconhecido.
java.util.concurrent.Future<IntentRecognitionResult>	recognizeOnceAsync(String text) Executa o reconhecimento de intenção e gera um resultado do texto passado.
void	setAuthorizationToken(String token) Define o token de autorização usado para se comunicar com o serviço.
java.util.concurrent.Future<java.lang.Void>	startContinuousRecognitionAsync() Inicia o reconhecimento de fala em um fluxo de áudio contínuo, até que pararo ReconhecimentoContínuoAssíncrono() seja chamado.
java.util.concurrent.Future<java.lang.Void>	startKeywordRecognitionAsync(KeywordRecognitionModel model) Configura o reconhecedor com o modelo de palavra-chave fornecido.
java.util.concurrent.Future<java.lang.Void>	stopContinuousRecognitionAsync() Interrompe uma operação de reconhecimento em execução o mais rápido possível e solicita imediatamente um resultado com base na entrada que foi processada até agora.
java.util.concurrent.Future<java.lang.Void>	stopKeywordRecognitionAsync() Encerra o reconhecimento iniciado palavra-chave.

Métodos herdados de Recognizer

canceledSetCallback close dispose doAsyncRecognitionAction getImpl getPropertyBagFromRecognizerHandle recognize recognizedSetCallback recognizingSetCallback sessionStartedEventCallback sessionStartedSetCallback sessionStoppedEventCallback sessionStoppedSetCallback speechEndDetectedEventCallback speechEndDetectedSetCallback speechStartDetectedEventCallback speechStartDetectedSetCallback startContinuousRecognition startKeywordRecognition stopContinuousRecognition stopKeywordRecognition

Métodos herdados de java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Detalhes do campo

canceled

public final EventHandlerImpl canceled

O evento cancelado sinaliza que o reconhecimento de intenção foi cancelado.

recognized

public final EventHandlerImpl recognized

O evento reconhecido sinaliza que um resultado de reconhecimento final é recebido.

recognizing

public final EventHandlerImpl recognizing

O evento reconhecendo sinais de que um resultado de reconhecimento intermediário é recebido.

Detalhes do construtor

IntentRecognizer

public IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig)

Cria uma nova instância de um reconhecedor de intenção com a configuração de fala inserida.

Parâmetros:

embeddedSpeechConfig - configuração de fala inserida.

IntentRecognizer

public IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig, AudioConfig audioConfig)

Cria uma nova instância de um reconhecedor de intenção com a configuração de fala inserida.

Parâmetros:

embeddedSpeechConfig - configuração de fala inserida.

audioConfig - configuração de áudio.

IntentRecognizer

public IntentRecognizer(SpeechConfig speechConfig)

Cria uma nova instância de um reconhecedor de intenção.

Parâmetros:

speechConfig - configuração de fala.

IntentRecognizer

public IntentRecognizer(SpeechConfig speechConfig, AudioConfig audioConfig)

Cria uma nova instância de um reconhecedor de intenção.

Parâmetros:

speechConfig - configuração de fala.

audioConfig - configuração de áudio.

Detalhes do método

addAllIntents

public void addAllIntents(LanguageUnderstandingModel model)

Adiciona todas as intenções do modelo de Reconhecimento vocal especificado.

Parâmetros:

model - O modelo de reconhecimento vocal que contém as intenções.

addAllIntents

public void addAllIntents(LanguageUnderstandingModel model, String intentId)

Adiciona todas as intenções do modelo de Reconhecimento vocal especificado.

Parâmetros:

model - O modelo de reconhecimento vocal que contém as intenções.

intentId - Uma cadeia de caracteres de id personalizada a ser retornada no método getIntentId() de IntentRecognitionResult.

addIntent

public void addIntent(LanguageUnderstandingModel model, String intentName)

Adiciona uma única intenção por nome do modelo de Reconhecimento vocal especificado.

Parâmetros:

model - O modelo de reconhecimento vocal que contém a intenção.

intentName - O nome da única intenção a ser incluída no modelo de compreensão da linguagem.

addIntent

public void addIntent(LanguageUnderstandingModel model, String intentName, String intentId)

Adiciona uma única intenção por nome do modelo de Reconhecimento vocal especificado.

Parâmetros:

model - O modelo de reconhecimento vocal que contém a intenção.

intentName - O nome da única intenção a ser incluída no modelo de compreensão da linguagem.

intentId - Uma cadeia de caracteres de id personalizada a ser retornada no método getIntentId() de IntentRecognitionResult.

addIntent

public void addIntent(String simplePhrase)

Adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica.

Parâmetros:

simplePhrase - A frase correspondente à intenção.

addIntent

public void addIntent(String simplePhrase, String intentId)

Adiciona uma frase simples que pode ser falada pelo usuário, indicando uma intenção de usuário específica.

Parâmetros:

simplePhrase - A frase correspondente à intenção.

intentId - Uma cadeia de caracteres de id personalizada a ser retornada no método getIntentId() de IntentRecognitionResult.

applyLanguageModels

public boolean applyLanguageModels(Collection collection)

Usa uma coleção de modelos de reconhecimento vocal, faz uma cópia deles e os aplica ao reconhecedor. Esse aplicativo entra em vigor em momentos diferentes, dependendo do tipo LanguageUnderstandingModel. PatternMatchingModels se tornará ativo imediatamente, enquanto LanguageUnderstandingModels utilizando o serviço LUIS ficará ativo imediatamente, a menos que o reconhecedor esteja no meio do reconhecimento de intenção, caso em que entrará em vigor após o próximo evento Reconhecido. Isso substitui todos os modelos aplicados anteriormente.

Parâmetros:

collection - Uma coleção de ponteiros compartilhados para LanguageUnderstandingModels.

Retornos:

True se a aplicação dos modelos entra em vigor imediatamente. Caso contrário, false.

Gera:

java.lang.NullPointerException - Se a coleção passada for nula.

dispose

protected void dispose(boolean disposing)

Esse método executa a limpeza de recursos. O descarte do parâmetro booliano indica se o método é chamado de Dispose (se disposing for true) ou do finalizador (se descartar for false). As classes derivadas devem substituir esse método para descartar o recurso, se necessário.

Substituições:

IntentRecognizer.dispose(boolean disposing)

Parâmetros:

disposing

getAuthorizationToken

public String getAuthorizationToken()

Obtém o token de autorização usado para se comunicar com o serviço.

Retornos:

Token de autorização.

getProperties

public PropertyCollection getProperties()

A coleção de propriedades e seus valores definidos para este IntentRecognizer.

Retornos:

A coleção de propriedades e seus valores definidos para este IntentRecognizer.

getSpeechRecognitionLanguage

public String getSpeechRecognitionLanguage()

Obtém a linguagem falada de reconhecimento.

Retornos:

a linguagem falada de reconhecimento.

recognizeOnceAsync

public Future recognizeOnceAsync()

Inicia o reconhecimento de intenção e retorna depois que um único enunciado é reconhecido. O fim de um único enunciado é determinado pela escuta de silêncio no fim ou até o máximo de 15 segundos de áudio processado. A tarefa retorna o texto de reconhecimento como resultado. Observação: como recognizeOnceAsync() retorna apenas um único enunciado, ele é adequado apenas para o reconhecimento de captura única, como comando ou consulta. Para reconhecimento de vários enunciados de longa duração, use startContinuousRecognitionAsync() em vez disso.

Retornos:

Uma tarefa que representa a operação de reconhecimento. A tarefa retorna um valor de IntentRecognitionResult

recognizeOnceAsync

public Future recognizeOnceAsync(String text)

Executa o reconhecimento de intenção e gera um resultado do texto passado. Isso é útil para testes e outras vezes em que a entrada de fala não está vinculada ao IntentRecognizer. Observação: atualmente, o Serviço de Intenção não dá suporte a isso, portanto, ele só é válido para correspondência de padrões offline ou intenções exatas de correspondência.

Parâmetros:

text - O texto a ser reconhecido para intenção.

Retornos:

Uma tarefa que representa a operação de reconhecimento. A tarefa retorna um valor de IntentRecognitionResult.

setAuthorizationToken

public void setAuthorizationToken(String token)

Define o token de autorização usado para se comunicar com o serviço. Observação: o chamador precisa garantir que o token de autorização seja válido. Antes que o token de autorização expire, o chamador precisa atualizá-lo chamando esse setter com um novo token válido. Caso contrário, o reconhecedor encontrará erros durante o reconhecimento.

Parâmetros:

token - Token de autorização.

startContinuousRecognitionAsync

public Future startContinuousRecognitionAsync()

Inicia o reconhecimento de fala em um fluxo de áudio contínuo, até que stopContinuousRecognitionAsync() seja chamado. O usuário deve assinar eventos para receber resultados de reconhecimento.

Retornos:

Uma tarefa que representa a operação assíncrona que inicia o reconhecimento.

startKeywordRecognitionAsync

public Future startKeywordRecognitionAsync(KeywordRecognitionModel model)

Configura o reconhecedor com o modelo de palavra-chave fornecido. Depois de chamar esse método, o reconhecedor está escutando o palavra-chave para iniciar o reconhecimento. Chame stopKeywordRecognitionAsync() para encerrar o reconhecimento iniciado palavra-chave. O usuário deve assinar eventos para receber resultados de reconhecimento.

Parâmetros:

model - O modelo de reconhecimento palavra-chave que especifica o palavra-chave a ser reconhecido.

Retornos:

Uma tarefa que representa a operação assíncrona que inicia o reconhecimento.

stopContinuousRecognitionAsync

public Future stopContinuousRecognitionAsync()

Interrompe uma operação de reconhecimento em execução o mais rápido possível e solicita imediatamente um resultado com base na entrada que foi processada até agora. Isso funciona para todas as operações de reconhecimento, não apenas as contínuas, e facilita o uso de botões push-to-talk ou "concluir agora" para ponto de extremidade de áudio manual.

Retornos:

Um futuro que será concluído quando o processamento de entrada for interrompido. A geração de resultados, se aplicável à entrada fornecida, pode ocorrer após a conclusão dessa tarefa e deve ser tratada com o evento apropriado.

stopKeywordRecognitionAsync

public Future stopKeywordRecognitionAsync()

Encerra o reconhecimento iniciado palavra-chave.

Retornos:

Uma tarefa que representa a operação assíncrona que interrompe o reconhecimento.