Compartir a través de

Clase Dialog::D ialogServiceConnector

  • Artículo
class Dialog::DialogServiceConnector
  : public std::enable_shared_from_this< DialogServiceConnector >
  : public Utils::NonCopyable
  : public Utils::NonMovable

Objeto usado para conectar DirectLineSpeech o CustomCommands.

Los objetos de este tipo se crean a través del método de fábrica FromConfig .

Miembros

Reconocido

Sintaxis: public EventSignal< constSpeechRecognitionEventArgs & > Recognized;

Señal de eventos que contienen resultados de reconocimiento de voz.

Reconociendo

Sintaxis: public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;

Señal de eventos que contienen resultados intermedios de reconocimiento.

SessionStarted

Sintaxis: public EventSignal< constSessionEventArgs & > SessionStarted;

Señales que indican el inicio de una sesión de escucha.

Sesión detenida

Sintaxis: public EventSignal< constSessionEventArgs & > SessionStopped;

Señal que indica el final de una sesión de escucha.

SpeechStartDetected

Sintaxis: public EventSignal< constRecognitionEventArgs & > SpeechStartDetected;

Señal que indica la primera detección de datos de voz en la frase actual.

SpeechEndDetected

Sintaxis: public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;

Señal que indica el final detectado de los datos de voz de la frase actual.

Canceled

Sintaxis: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Señal de eventos relacionados con la cancelación de una interacción. El evento indica si el motivo es una cancelación directa o un error.

ActivityReceived

Sintaxis: public EventSignal< constActivityReceivedEventArgs & > ActivityReceived;

Indica que se recibió una actividad del back-end.

TurnStatusReceived

Sintaxis: public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;

Indica que se recibió una actualización de estado de turno del back-end.

Propiedades

Sintaxis: public PropertyCollection & Properties;

Colección de propiedades y sus valores definidos para este DialogServiceConnector.

~DialogServiceConnector

Sintaxis: public inline virtual ~DialogServiceConnector ( );

Destruye la instancia.

ConnectAsync

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

Se conecta con el back-end.

Devoluciones

Una operación asincrónica que inicia la conexión.

DisconnectAsync

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

Se desconecta del back-end.

Devoluciones

Una operación asincrónica que inicia la desconexión.

SendActivityAsync

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

Envía una actividad al cuadro de diálogo de respaldo.

Parámetros

  • activity Actividad que se va a enviar

Devoluciones

Una operación asincrónica que inicia la operación.

StartKeywordRecognitionAsync

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

Inicia el reconocimiento de palabras clave.

Parámetros

  • model Especifica el modelo de palabras clave que se va a usar.

Devoluciones

Una operación asincrónica que inicia la operación.

StopKeywordRecognitionAsync

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

Detenga el reconocimiento de palabras clave.

Devoluciones

Una operación asincrónica que inicia la operación.

ListenOnceAsync

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

Inicia una sesión de escucha que finalizará después de la primera expresión.

Devoluciones

Una operación asincrónica que inicia la operación.

StopListeningAsync

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

Solicita que una operación de escucha activa finalice inmediatamente, interrumpa cualquier habla en curso y proporcione un resultado que refleje los datos de audio capturados hasta ahora.

Devoluciones

Tarea que representa la operación asincrónica que detiene una sesión de escucha activa.

SetAuthorizationToken

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

Establece el token de autorización que se usará para conectarse al servicio. Nota: El autor de la llamada debe asegurarse de que el token de autorización es válido. Antes de que expire el token de autorización, el autor de la llamada debe actualizarlo llamando a este establecedor con un nuevo token válido. De lo contrario, el conector encontrará errores durante su operación.

Parámetros

  • token Token de autorización.

GetAuthorizationToken

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

Obtiene el token de autorización.

Devoluciones

El token de autorización

SetSpeechActivityTemplate

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

Establece una plantilla JSON que se proporcionará al servicio de voz para la siguiente conversación. El servicio intentará combinar esta plantilla en todas las actividades enviadas al back-end de diálogo, independientemente de si el cliente lo originó con SendActivityAsync o generado por el servicio, como sucede con los resultados de conversión de voz a texto.

Parámetros

  • activityTemplate La carga de actividad, como una cadena JSON, que se va a combinar en todos los mensajes de actividad aplicables.

GetSpeechActivityTemplate

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

Obtiene la plantilla JSON que se proporcionará al servicio de voz para la siguiente conversación. El servicio intentará combinar esta plantilla en todas las actividades enviadas al back-end de diálogo, independientemente de si el cliente lo originó con SendActivityAsync o generado por el servicio, como sucede con los resultados de conversión de voz a texto.

Devoluciones

La plantilla de actividad JSON establecida actualmente que se usará en las solicitudes posteriores.

FromConfig

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

Crea un conector de servicio de diálogo a partir de dialogServiceConfig y audio ::AudioConfig. Los usuarios deben usar esta función para crear un conector de servicio de diálogo.

Parámetros

  • connectorConfig Configuración del servicio de diálogo.

  • audioConfig Configuración de audio.

Devoluciones

Puntero inteligente compartido del conector de servicio de diálogo creado.

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

Al hablar de DialogServiceConfig nos referimos a una de las clases que heredan de él. La clase específica que se va a usar depende del back-end del diálogo que se use: