Connection Classe

Pacote:

com.microsoft.cognitiveservices.speech

Artefato Maven:

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

• java.lang.Object
• • com.microsoft.cognitiveservices.speech.Connection

Implementações

java.lang.AutoCloseable

public final class Connection
implements java.lang.AutoCloseable

Connection é uma classe proxy para gerenciar a conexão com o serviço de fala do Reconhecedor especificado. Por padrão, um Reconhecedor gerencia de forma autônoma a conexão com o serviço quando necessário. A classe Connection fornece métodos adicionais para que os usuários abram ou fechem explicitamente uma conexão e assinem a conexão status alterações. O uso de Conexão é opcional. Destina-se a cenários em que é necessário ajustar o comportamento do aplicativo com base em status de conexão. Opcionalmente, os usuários podem chamar openConnection() para iniciar manualmente uma conexão de serviço antes de iniciar o reconhecimento no Reconhecedor associado a essa Conexão. Depois de iniciar um reconhecimento, a chamada de openConnection() ou closeConnection() pode falhar. Isso não afetará o Reconhecedor nem o reconhecimento contínuo. A conexão pode cair por vários motivos, o Reconhecedor sempre tentará reinstituir a conexão conforme necessário para garantir operações em andamento. Em todos esses casos, eventos conectados/desconectados indicarão a alteração do status de conexão. Observação: close() deve ser chamado para liberar recursos subjacentes mantidos pelo objeto . Atualizado na versão 1.17.0.

Resumo do campo

Modificador e tipo	Campo e descrição
final EventHandlerImpl<ConnectionEventArgs>	connected O evento Connected para indicar que o reconhecedor está conectado ao serviço.
final EventHandlerImpl<ConnectionEventArgs>	disconnected O evento Disconnected para indicar que o reconhecedor está desconectado do serviço.
final EventHandlerImpl<ConnectionMessageEventArgs>	messageReceived O evento MessageReceived indica que o serviço enviou uma mensagem de rede para o cliente.

Resumo do método

Modificador e tipo	Método e descrição
void	close() Descarte os recursos associados.
void	closeConnection() Fecha a conexão do serviço.
static Connection	fromConversationTranslator(ConversationTranslator conversationTranslator) Obtém a instância de Conexão do tradutor de conversa.
static Connection	fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector) Obtém a instância de Conexão do conector do serviço de caixa de diálogo.
static Connection	fromRecognizer(Recognizer recognizer) Obtém a instância de Conexão do reconhecedor especificado.
static Connection	fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer) Obtém a instância de Conexão do sintetizador de fala.
void	openConnection(boolean forContinuousRecognition) Começa a configurar a conexão com o serviço.
java.util.concurrent.Future<java.lang.Void>	sendMessageAsync(String path, String payload) Envia uma mensagem para o serviço.
void	setMessageProperty(String path, String propertyName, String propertyValue) Acrescenta um parâmetro em uma mensagem ao serviço.

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

connected

public final EventHandlerImpl connected

O evento Connected para indicar que o reconhecedor está conectado ao serviço. Para receber o evento conectado depois de assinar, o próprio objeto Connection precisa estar ativo. Se o objeto Connection que possui esse evento estiver fora de seu tempo de vida útil, todos os eventos inscritos não serão entregues.

disconnected

public final EventHandlerImpl disconnected

O evento Disconnected para indicar que o reconhecedor está desconectado do serviço. Para receber o evento desconectado depois de assinar, o próprio objeto Connection precisa estar ativo. Se o objeto Connection que possui esse evento estiver fora de seu tempo de vida útil, todos os eventos inscritos não serão entregues.

messageReceived

public final EventHandlerImpl messageReceived

O evento MessageReceived indica que o serviço enviou uma mensagem de rede para o cliente. Adicionado na versão 1.15.0.

Detalhes do método

close

public void close()

Descarte os recursos associados. close() deve ser chamado para renunciar aos recursos subjacentes corretamente.

closeConnection

public void closeConnection()

Fecha a conexão do serviço. Opcionalmente, os usuários podem chamar closeConnection() para desligar manualmente a conexão do Reconhecedor associado. A chamada pode falhar, dependendo do estado do processo do Reconhecedor. Mas a falha não afeta o estado do Reconhecedor associado.

fromConversationTranslator

public static Connection fromConversationTranslator(ConversationTranslator conversationTranslator)

Obtém a instância de Conexão do tradutor de conversa.

Parameters:

conversationTranslator - O conversationTranslator associado à conexão.

Returns:

A instância de Conexão do reconhecedor.

fromDialogServiceConnector

public static Connection fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector)

Obtém a instância de Conexão do conector do serviço de caixa de diálogo.

Parameters:

dialogServiceConnector - O conector do serviço de caixa de diálogo associado à conexão, usado para observar e gerenciar o estado da conexão com o serviço de fala.

Returns:

A instância de Conexão do conector do serviço de caixa de diálogo.

fromRecognizer

public static Connection fromRecognizer(Recognizer recognizer)

Obtém a instância de Conexão do reconhecedor especificado.

Parameters:

recognizer - O reconhecedor associado à conexão.

Returns:

A instância de Conexão do reconhecedor.

fromSpeechSynthesizer

public static Connection fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer)

Obtém a instância de Conexão do sintetizador de fala. Adicionado na versão 1.17.0

Parameters:

speechSynthesizer - O sintetizador de fala associado à conexão, usado para observar e gerenciar o estado da conexão com o serviço de fala.

Returns:

A instância connection do sintetizador de fala.

openConnection

public void openConnection(boolean forContinuousRecognition)

Começa a configurar a conexão com o serviço. Opcionalmente, os usuários podem chamar openConnection() para configurar manualmente uma conexão com antecedência antes de iniciar o reconhecimento no Reconhecedor associado a essa Conexão. Depois de iniciar o reconhecimento, chamar OpenConnection() pode falhar, dependendo do estado do processo do Reconhecedor. Mas a falha não afeta o estado do Reconhecedor associado. Observação: no retorno, a conexão pode não estar pronta ainda. Assine o evento Connected para ser notificado quando a conexão for estabelecida.

Parameters:

forContinuousRecognition - indica se a conexão é usada para reconhecimento contínuo ou reconhecimento de tiro único. Não terá efeito se a conexão for do SpeechSynthsizer.

sendMessageAsync

public Future sendMessageAsync(String path, String payload)

Envia uma mensagem para o serviço. Adicionado na versão 1.7.0 Observação: esse método não funciona para a conexão do SpeechSynthesizer.

Parameters:

path - O caminho da mensagem.

payload - A carga de mensagem.

Returns:

um futuro que representa a operação assíncrona que envia a mensagem.

setMessageProperty

public void setMessageProperty(String path, String propertyName, String propertyValue)

Acrescenta um parâmetro em uma mensagem ao serviço. Adicionado na versão 1.7.0 Observação: esse método não funciona para a conexão do SpeechSynthesizer.

Parameters:

path - O caminho da mensagem.

propertyName - O nome da propriedade que você deseja definir.

propertyValue - O valor da propriedade que você deseja definir.