conexão de classe

class Connection
  : public std::enable_shared_from_this< Connection >

A conexão é 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 as alterações de status da conexão. O uso da Conexão é opcional. Destina-se a cenários em que o ajuste fino do comportamento do aplicativo com base no status da conexão é necessário. 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 ou o reconhecimento contínuo. A conexão pode ser suspensa 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 da conexão. Atualizado na versão 1.17.0.

Membros

Conectado

Sintaxe: public EventSignal< const ConnectionEventArgs & > Connected;

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

Desconectado

Sintaxe: public EventSignal< const ConnectionEventArgs & > Disconnected;

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

MessageReceived

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.

Abrir

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 ainda não estar pronta. Assine o evento Conectado 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. 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.

Devoluções

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

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

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

Devoluções

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.

Devoluções

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.

Devoluções

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.

Devoluções

A instância de conexão do sintetizador de fala.