Compartilhar via

classe Dialog::D ialogServiceConnector

  • Artigo
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< constSpeechRecognitionEventArgs & > Recognized;

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

Reconhecendo

Sintaxe: public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;

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

SessionStarted

Sintaxe: public EventSignal< constSessionEventArgs & > SessionStarted;

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

SessionStopped

Sintaxe: public EventSignal< constSessionEventArgs & > SessionStopped;

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

SpeechStartDetected

Sintaxe: public EventSignal< constRecognitionEventArgs & > SpeechStartDetected;

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

SpeechEndDetected

Sintaxe: public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;

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

Canceled

Sintaxe: public EventSignal< constSpeechRecognitionCanceledEventArgs & > 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< constActivityReceivedEventArgs & > ActivityReceived;

Sinaliza que uma atividade foi recebida do back-end.

TurnStatusReceived

Sintaxe: public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;

Sinaliza que uma status atualização 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.

Retornos

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

Disconnectasync

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

Desconecta-se do back-end.

Retornos

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

  • activity Atividade a ser enviada

Retornos

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

StartKeywordRecognitionAsync

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

Inicia palavra-chave reconhecimento.

Parâmetros

  • modelEspecifica o modelo de palavra-chave a ser usado.

Retornos

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

StopKeywordRecognitionAsync

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

Interrompa palavra-chave reconhecimento.

Retornos

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 terminará após o primeiro enunciado.

Retornos

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 os dados de áudio capturados até agora.

Retornos

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.

Retornos

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 conversão 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 para o back-end da caixa de diálogo, seja originada pelo cliente com SendActivityAsync ou gerada pelo serviço, como é o caso dos resultados de conversão de fala em texto.

Retornos

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

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

  • audioConfig Configuração de áudio.

Retornos

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: