Partilhar via

ligação de classe

  • Artigo
class Connection
  : public std::enable_shared_from_this< Connection >

A ligação é uma classe proxy para gerir a ligação ao serviço de voz do Reconhecedor especificado. Por predefinição, um Reconhecedor gere de forma autónoma a ligação ao serviço quando necessário. A classe Ligação fornece métodos adicionais para os utilizadores abrirem ou fecharem explicitamente uma ligação e subscreverem alterações ao estado da ligação. A utilização da Ligação é opcional. Destina-se a cenários em que é necessária uma otimização do comportamento da aplicação com base no estado da ligação. Opcionalmente, os utilizadores podem chamar Open() para iniciar manualmente uma ligação de serviço antes de iniciar o reconhecimento no Reconhecedor associado a esta Ligação. Depois de iniciar um reconhecimento, chamar Abrir() ou Fechar() pode falhar. Isto não afetará o Reconhecedor ou o reconhecimento contínuo. A ligação pode ser perdida por vários motivos, o Reconhecedor tentará sempre reinstituir a ligação conforme necessário para garantir operações em curso. Em todos estes casos, eventos ligados/desligados indicarão a alteração do estado da ligação. Atualizado na versão 1.17.0.

Membros

Ligada

Sintaxe: public EventSignal< constConnectionEventArgs & > Connected;

O evento Ligado para indicar que o reconhecedor está ligado ao serviço.

Desligado

Sintaxe: public EventSignal< constConnectionEventArgs & > Disconnected;

O evento Desligado para indicar que o reconhecedor está desligado 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.

Abrir

Sintaxe: public inline void Open ( bool forContinuousRecognition );

Começa a configurar a ligação ao serviço. Opcionalmente, os utilizadores podem chamar Open() para configurar manualmente uma ligação com antecedência antes de iniciarem o reconhecimento/sintetização no Reconhecedor/Sintetizador associado a esta Ligação. Após iniciar o reconhecimento, a chamada Open() poderá falhar, dependendo do estado do processo do Reconhecedor/Sintetizador. Mas a falha não afeta o estado do Reconhecedor/Sintetizador associado. Nota: na devolução, a ligação poderá ainda não estar pronta. Subscreva o evento Ligado para ser notificado quando a ligação for estabelecida.

Parâmetros

  • forContinuousRecognition Indica se a ligação é utilizada para reconhecimento contínuo ou reconhecimento de tiro único. Não tem qualquer efeito se a ligação for do SpeechSynthsizer.

Fechar

Sintaxe: public inline void Close ( );

Fecha a ligação do serviço. Opcionalmente, os utilizadores podem chamar Fechar() para encerrar manualmente a ligaçã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 numa mensagem ao serviço. Este método não funciona para a ligação de 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 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 voz. Este método não funciona para a ligação de SpeechSynthesizer. Adicionado na versão 1.7.0.

Parâmetros

  • path O caminho da mensagem.

  • payload O payload da mensagem. Esta é uma cadeia de 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 ligação de SpeechSynthesizer. Adicionado na versão 1.10.0.

Parâmetros

  • path O caminho da mensagem.

  • payload O payload binário da mensagem.

  • size O tamanho do payload binário.

Devoluções

Um futuro vazio.

Ligação

Sintaxe: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Construtor interno. Cria uma nova instância com a alça fornecida.

Parâmetros

  • handle A alça de ligação.

~Ligação

Sintaxe: public inline ~Connection ( );

Destrutor.

FromRecognizer

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

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

Parâmetros

  • recognizer O reconhecedor associado à ligação.

Devoluções

A instância de Ligaçã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 Ligação a partir do tradutor de conversação especificado.

Parâmetros

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

Devoluções

A instância de Ligação 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 de ligação do conector do serviço de caixa de diálogo especificado, utilizado para observar e gerir a ligação e a desativação do serviço de voz.

Parâmetros

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

Devoluções

A Instância de ligaçã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 ligação do sintetizador de voz especificado. Adicionado na versão 1.17.0.

Parâmetros

  • synthesizer O sintetizador de voz associado à ligação.

Devoluções

A Instância de ligação do sintetizador de voz.