caixa de diálogo da classe::D ialogServiceConnector

class Dialog::DialogServiceConnector
  : public std::enable_shared_from_this< DialogServiceConnector >
  : public Utils::NonCopyable
  : public Utils::NonMovable

Objeto usado para conectar DirectLineSpeech ou CustomCommands.

Objetos desse tipo são criados por meio do método de fábrica FromConfig.

Membros

Reconhecido

Sintaxe: public EventSignal< const SpeechRecognitionEventArgs & > Recognized;

Sinal para eventos que contêm resultados de reconhecimento de fala.

Reconhecendo

Sintaxe: public EventSignal< const SpeechRecognitionEventArgs & > Recognizing;

Sinal para eventos que contêm resultados de reconhecimento intermediários.

SessionStarted

Sintaxe: public EventSignal< const SessionEventArgs & > SessionStarted;

Sinais que indicam o início de uma sessão de escuta.

SessionStopped

Sintaxe: public EventSignal< const SessionEventArgs & > SessionStopped;

Sinal que indica o fim de uma sessão de escuta.

SpeechStartDetected

Sintaxe: public EventSignal< const RecognitionEventArgs & > SpeechStartDetected;

Sinal que indica a primeira detecção de dados de fala na frase atual.

SpeechEndDetected

Sintaxe: public EventSignal< const RecognitionEventArgs & > SpeechEndDetected;

Sinal que indica o fim detectado dos dados de fala da frase atual.

Cancelado

Sintaxe: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Sinal para eventos relacionados ao cancelamento de uma interação. O evento indica se o motivo é um cancelamento direto ou um erro.

ActivityReceived

Sintaxe: public EventSignal< const ActivityReceivedEventArgs & > ActivityReceived;

Sinaliza que uma atividade foi recebida do back-end.

TurnStatusReceived

Sintaxe: public EventSignal< const TurnStatusReceivedEventArgs & > TurnStatusReceived;

Sinaliza que uma atualização de status de turno foi recebida do back-end.

Propriedades

Sintaxe: public PropertyCollection & Properties;

Uma coleção de propriedades e seus valores definidos para este DialogServiceConnector.

~DialogServiceConnector

Sintaxe: public inline virtual ~DialogServiceConnector ( );

Destrói a instância.

ConnectAsync

Sintaxe: public inline std::future< void > ConnectAsync ( );

Conecta-se com o back-end.

Devoluções

Uma operação assíncrona que inicia a conexão.

DisconnectAsync

Sintaxe: public inline std::future< void > DisconnectAsync ( );

Desconecta-se do back-end.

Devoluções

Uma operação assíncrona que inicia a desconexão.

SendActivityAsync

Sintaxe: public inline std::future< std::string > SendActivityAsync ( const std::string & activity );

Envia uma atividade para a caixa de diálogo de backup.

Parâmetros

  • Atividade activity a ser enviada

Devoluções

Uma operação assíncrona que inicia a operação.

StartKeywordRecognitionAsync

Sintaxe: public inline std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Inicia o reconhecimento de palavra-chave.

Parâmetros

  • model Especifica o modelo de palavra-chave a ser usado.

Devoluções

Uma operação assíncrona que inicia a operação.

StopKeywordRecognitionAsync

Sintaxe: public inline std::future< void > StopKeywordRecognitionAsync ( );

Interromper o reconhecimento de palavra-chave.

Devoluções

Uma operação assíncrona que inicia a operação.

ListenOnceAsync

Sintaxe: public inline std::future< std::shared_ptr< SpeechRecognitionResult > > ListenOnceAsync ( );

Inicia uma sessão de escuta que será encerrada após o primeiro enunciado.

Devoluções

Uma operação assíncrona que inicia a operação.

StopListeningAsync

Sintaxe: public inline std::future< void > StopListeningAsync ( );

Solicita que uma operação de escuta ativa seja concluída imediatamente, interrompendo qualquer fala em andamento e forneça um resultado que reflita quaisquer dados de áudio que foram capturados até agora.

Devoluções

Uma tarefa que representa a operação assíncrona que interrompe uma sessão de escuta ativa.

SetAuthorizationToken

Sintaxe: public inline void SetAuthorizationToken ( const std::string & token );

Define o token de autorização que será usado para se conectar ao serviço. Observação: o chamador precisa garantir que o token de autorização seja válido. Antes que o token de autorização expire, o chamador precisa atualizá-lo chamando esse setter com um novo token válido. Caso contrário, o conector encontrará erros durante sua operação.

Parâmetros

  • token o token de autorização.

GetAuthorizationToken

Sintaxe: public inline std::string GetAuthorizationToken ( );

Obtém o token de autorização.

Devoluções

Token de autorização

SetSpeechActivityTemplate

Sintaxe: public inline void SetSpeechActivityTemplate ( const std::string & activityTemplate );

Define um modelo JSON que será fornecido ao serviço de fala para a próxima conversa. O serviço tentará mesclar esse modelo em todas as atividades enviadas ao back-end da caixa de diálogo, seja originadas pelo cliente com SendActivityAsync ou geradas pelo serviço, como é o caso dos resultados de fala em texto.

Parâmetros

  • activityTemplate o conteúdo da atividade, como uma cadeia de caracteres JSON, a ser mesclado em todas as mensagens de atividade aplicáveis.

GetSpeechActivityTemplate

Sintaxe: public inline std::string GetSpeechActivityTemplate ( );

Obtém o modelo JSON que será fornecido ao serviço de fala para a próxima conversa. O serviço tentará mesclar esse modelo em todas as atividades enviadas ao back-end da caixa de diálogo, seja originadas pelo cliente com SendActivityAsync ou geradas pelo serviço, como é o caso dos resultados de fala em texto.

Devoluções

O modelo de atividade JSON atualmente definido que será usado em solicitações subsequentes.

FromConfig

Sintaxe: public inline static std::shared_ptr< DialogServiceConnector > FromConfig ( std::shared_ptr< DialogServiceConfig > connectorConfig , std::shared_ptr< Audio::AudioConfig > audioConfig );

Cria um conector de serviço de caixa de diálogo a partir de um dialogServiceConfig e um Audio::AudioConfig. Os usuários devem usar essa função para criar um conector de serviço de caixa de diálogo.

Parâmetros

  • configuração do serviço de caixa de diálogo connectorConfig.

  • configuração de áudio audioConfig.

Devoluções

O ponteiro inteligente compartilhado do conector do serviço de caixa de diálogo criado.

auto audioConfig = [Audio::AudioConfig::FromDefaultMicrophoneInput](audio-audioconfig.md#fromdefaultmicrophoneinput)();
auto config = [CustomCommandsConfig::FromAuthorizationToken](dialog-customcommandsconfig.md#fromauthorizationtoken)("my_app_id","my_auth_token", "my_region");
auto connector = [DialogServiceConnector::FromConfig](#fromconfig)(config, audioConfig);

Ao falar em DialogServiceConfig estamos nos referindo a uma das classes que herdam dela. A classe específica a ser usada depende do back-end da caixa de diálogo que está sendo usado:

  • BotFrameworkConfig para DirectLineSpeech

  • CustomCommandsConfig para CustomCommands