Conexão de classe

class Connection
  : public std::enable_shared_from_this< Connection >

Connection é uma classe proxy para gerenciar a conexão com o serviço de fala do Recognizer especificado. Por padrão, um Recognizer 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 as alterações de status da conexão. O uso de Conexão é opcional. Destina-se a cenários em que é necessário ajustar o comportamento do aplicativo com base no status da conexão. Opcionalmente, os usuários podem chamar Open() para iniciar manualmente uma conexão de serviço antes de iniciar o reconhecimento no Recognizer associado a essa conexão. Depois de iniciar um reconhecimento, chamar Open() ou Close() pode falhar. Isso não afetará o Reconhecedor ou o reconhecimento contínuo. A conexão pode cair por vários motivos, o Recognizer sempre tentará reinstituir a conexão conforme necessário para garantir operações contínuas. Em todos esses casos, os eventos Conectado/Desconectado indicarão a alteração do status da conexão. Atualizado na versão 1.17.0.

Membros

Ligado

Sintaxe: public EventSignal< const ConnectionEventArgs & > Connected;

O evento Connected para indicar que o reconhecedor está conectado ao serviço.

Desconectado

Sintaxe: public EventSignal< const ConnectionEventArgs & > Disconnected;

O evento Disconnected para indicar que o reconhecedor está desconectado do serviço.

MensagemRecebida

Sintaxe: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

O evento MessageReceived para indicar que o protocolo subjacente recebeu uma mensagem do serviço. Adicionado na versão 1.10.0.

Aberto

Sintaxe: public inline void Open ( bool forContinuousRecognition );

Começa a configurar a conexão com o serviço. Opcionalmente, os usuários podem chamar Open() para configurar manualmente uma conexão com antecedência antes de iniciar o reconhecimento/síntese no Reconhecedor/Sintetizador associado a essa conexão. Depois de iniciar o reconhecimento, chamar Open() pode falhar, dependendo do estado do processo do Reconhecedor/Sintetizador. Mas a falha não afeta o estado do Reconhecedor/Sintetizador associado. Nota: No retorno, a conexão pode não estar pronta ainda. Inscreva-se no evento Connected para ser notificado quando a conexão for estabelecida.

Parâmetros

• forContinuousRecognition Indica se a conexão é usada para reconhecimento contínuo ou reconhecimento de captura única. Não terá efeito se a conexão for do SpeechSynthsizer.

Fechar

Sintaxe: public inline void Close ( );

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

SetMessageProperty

Sintaxe: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

Acrescenta um parâmetro em uma mensagem ao serviço. Adicionado na versão 1.7.0.

Parâmetros

• path o caminho da mensagem.

• propertyName Nome do imóvel.

• propertyValue Valor do imóvel. Esta é uma cadeia de caracteres json.

Devoluções

nulo.

SendMessageAsync

Sintaxe: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );

Envie uma mensagem para o serviço de voz. Adicionado na versão 1.7.0.

Parâmetros

• path O caminho da mensagem.

• payload A carga útil da mensagem. Esta é uma cadeia de caracteres json.

Devoluções

Um futuro vazio.

SendMessageAsync

Sintaxe: public inline std::future< void > SendMessageAsync ( const std::string & path , uint8_t * payload , uint32_t size );

Envie uma mensagem binária para o serviço de voz. Este método não funciona para a conexão de SpeechSynthesizer. Adicionado na versão 1.10.0.

Parâmetros

• path O caminho da mensagem.

• payload A carga binária da mensagem.

• size O tamanho da carga útil binária.

Devoluções

Um futuro vazio.

Conexão

Sintaxe: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Construtor interno. Cria uma nova instância usando o identificador fornecido.

Parâmetros

• handle A alça de conexão.

~Conexão

Sintaxe: public inline ~Connection ( );

Destruidor.

FromRecognizer

Sintaxe: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Obtém a instância Connection do reconhecedor especificado.

Parâmetros

• recognizer O reconhecedor associado à conexão.

Devoluções

A instância Connection do reconhecedor.

FromConversationTranslator

Sintaxe: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );

Obtém a instância Connection do conversor de conversação especificado.

Parâmetros

• convTrans O tradutor de conversação associado à conexão.

Devoluções

A instância Connection do tradutor de conversação.

FromDialogServiceConnector

Sintaxe: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );

Obtém a instância Connection do conector de serviço de diálogo especificado, usado para observar e gerenciar a conexão e a desconexão do serviço de fala.

Parâmetros

• dialogServiceConnector O conector do serviço de diálogo associado à conexão.

Devoluções

A instância Connection do conector do serviço de diálogo.

FromSpeechSynthesizer

Sintaxe: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

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

Parâmetros

• synthesizer O sintetizador de voz associado à conexão.

Devoluções

A instância Connection do sintetizador de voz.