Compartilhar via

conexão de classe

  • Artigo
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 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 Open() 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 Open() ou Close() 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. Atualizado na versão 1.17.0.

Membros

Conectado

Sintaxe: public EventSignal< constConnectionEventArgs & > Connected;

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

Desconectado

Sintaxe: public EventSignal< constConnectionEventArgs & > Disconnected;

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

MessageReceived

Sintaxe: public EventSignal< constConnectionMessageEventArgs & > 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, a chamada de Open() pode falhar, dependendo do estado do processo do Reconhecedor/Sintetizador. Mas a falha não afeta o estado do Reconhecedor/Sintetizador 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.

Parâmetros

  • 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.

Fechar

Sintaxe: public inline void Close ( );

Fecha a conexão do serviço. Opcionalmente, os usuários podem 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. Esse método não funciona para a conexão do SpeechSynthesizer. Adicionado na versão 1.7.0.

Parâmetros

  • path o caminho da mensagem.

  • propertyName Nome da propriedade .

  • propertyValue Valor da propriedade . Esta é uma cadeia de caracteres json.

Retornos

Vazio.

SendMessageAsync

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

Envie uma mensagem para o serviço de fala. Esse método não funciona para a conexão do SpeechSynthesizer. Adicionado na versão 1.7.0.

Parâmetros

  • path O caminho da mensagem.

  • payload O conteúdo da mensagem. Esta é uma cadeia de caracteres json.

Retornos

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 fala. Esse método não funciona para a conexão do SpeechSynthesizer. Adicionado na versão 1.10.0.

Parâmetros

  • path O caminho da mensagem.

  • payload O conteúdo binário da mensagem.

  • size O tamanho do conteúdo binário.

Retornos

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 O identificador 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 de Conexão do reconhecedor especificado.

Parâmetros

  • recognizer O reconhecedor associado à conexão.

Retornos

A instância de Conexão do reconhecedor.

FromConversationTranslator

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

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

Parâmetros

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

Retornos

A instância de Conexão do tradutor de conversa.

FromDialogServiceConnector

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

Obtém a instância de Conexão do conector do serviço de caixa 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 caixa de diálogo associado à conexão.

Retornos

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

FromSpeechSynthesizer

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

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

Parâmetros

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

Retornos

A instância connection do sintetizador de fala.