caixa de diálogo de classe::D ialogServiceConnector

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

Objeto utilizado para ligar DirectLineSpeech ou CustomCommands.

Os objetos deste tipo são criados através do método de fábrica FromConfig .

Membros

Reconhecido

Sintaxe: public EventSignal< constSpeechRecognitionEventArgs & > Recognized;

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

Reconhecer

Sintaxe: public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;

Sinal para eventos que contêm resultados de reconhecimento intermédio.

SessionStarted

Sintaxe: public EventSignal< constSessionEventArgs & > SessionStarted;

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

SessõesTopped

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 deteção de dados de voz na expressão atual.

SpeechEndDetected

Sintaxe: public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;

Sinal que indica o fim detetado dos dados de voz da expressão atual.

Cancelado

Sintaxe: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

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

ActivityReceived

Sintaxe: public EventSignal< constActivityReceivedEventArgs & > ActivityReceived;

Indica que uma atividade foi recebida do back-end.

TurnStatusReceived

Sintaxe: public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;

Indica que foi recebida uma atualização de estado de viragem a partir do back-end.

Propriedades

Sintaxe: public PropertyCollection & Properties;

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

~DialogServiceConnector

Sintaxe: public inline virtual ~DialogServiceConnector ( );

Destrói a instância.

ConnectAsync

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

Liga-se com o back-end.

Devoluções

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

DisconnectAsync

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

Desliga-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 cópia de segurança.

Parâmetros

  • activity Atividade a enviar

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

Parâmetros

  • model Especifica o modelo de palavra-chave a utilizar.

Devoluções

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

StopKeywordRecognitionAsync

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

Pare o reconhecimento de palavras-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 terminará após a primeira expressão.

Devoluções

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

StopListeningAsync

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

Pede que uma operação de escuta ativa termine imediatamente, interrompendo qualquer voz em curso e forneça um resultado que reflita quaisquer dados de áudio capturados até ao momento.

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á utilizado para ligar ao serviço. Nota: o autor da chamada tem de garantir que o token de autorização é válido. Antes de o token de autorização expirar, o autor da chamada tem de o atualizar ao chamar este setter com um novo token válido. Caso contrário, o conector deteta erros durante a 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 voz para a conversação seguinte. O serviço tentará intercalar este modelo em todas as atividades enviadas para o back-end da caixa de diálogo, quer seja originado pelo cliente com SendActivityAsync ou gerado pelo serviço, como é o caso dos resultados da conversão de voz em texto.

Parâmetros

  • activityTemplate O payload de atividade, como uma cadeia JSON, a ser intercalado 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 voz para a próxima conversação. O serviço tentará intercalar este modelo em todas as atividades enviadas para o back-end da caixa de diálogo, seja originado pelo cliente com SendActivityAsync ou gerado pelo serviço, como é o caso dos resultados de conversão de voz em texto.

Devoluções

O modelo de atividade JSON atualmente definido que será utilizado em pedidos 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 de Audio::AudioConfig. Os utilizadores devem utilizar esta 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.

Devoluções

O ponteiro inteligente partilhado do conector do serviço 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 a referir-nos a uma das classes que herdam da mesma. A classe específica a utilizar depende do back-end da caixa de diálogo que está a ser utilizado: