Compartir a través de


ActivityHandler Clase

Definición

Una implementación de la IBot interfaz, pensada para subclases adicionales.

public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
    interface IBot
Public Class ActivityHandler
Implements IBot
Herencia
ActivityHandler
Derivado
Implementaciones

Comentarios

Derive de esta clase para conectar código para controlar determinados tipos de actividad. El procesamiento previo y posterior de los objetos se puede agregar llamando a la implementación de Activity clase base desde la clase derivada.

Constructores

ActivityHandler()

Una implementación de la IBot interfaz, pensada para subclases adicionales.

Métodos

CreateInvokeResponse(Object)

Un InvokeResponse generador que inicializa el cuerpo en el parámetro pasado y el estado es igual a Correcto.

OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)

Se invoca cuando el bot se envía una acción de tarjeta adaptable Ejecutada.

OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)

Se invoca cuando se recibe una actividad de comando cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Los comandos son solicitudes para realizar una acción y los receptores suelen responder con una o varias actividades commandResult. También se espera que los receptores rechacen explícitamente las actividades de comandos no admitidas.

OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken)

Se invoca cuando se recibe una actividad CommandResult cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Las actividades CommandResult se pueden usar para comunicar el resultado de una ejecución de comandos.

OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)

Se invoca cuando se recibe una actividad de actualización de conversación desde el canal cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Las actividades de actualización de conversación son útiles cuando se trata de responder a los usuarios que se agregan o quitan de la conversación. Por ejemplo, un bot podría responder a un usuario que el usuario está agregando. De forma predeterminada, este método llamará a OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) si se han agregado usuarios o OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) si se han quitado usuarios. El método comprueba el identificador de miembro para que solo responda a las actualizaciones relacionadas con miembros distintos del propio bot.

OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica específica de EndOfConversation las actividades, como la lógica conversacional.

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)

Se invoca cuando se recibe una actividad de evento del conector cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Las actividades de eventos se pueden usar para comunicar muchas cosas diferentes. De forma predeterminada, este método llamará OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) si el nombre de la actividad es tokens/response o OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) de otro modo. Un tokens/response evento se puede desencadenar mediante .OAuthCard

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Se invoca cuando se recibe un evento distinto tokens/response de cuando se usa el comportamiento base de OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) . Opcionalmente, este método se podría invalidar si el bot está diseñado para controlar eventos varios. De forma predeterminada, este método no hace nada.

OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica específica de las InstallationUpdate actividades.

OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica específica de las InstallationUpdate actividades con "action" establecido en "add".

OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica específica de las InstallationUpdate actividades con "action" establecido en "remove".

OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)

Se invoca cuando se recibe una actividad de invocación del conector cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Las actividades de invocación se pueden usar para comunicar muchas cosas diferentes. De forma predeterminada, este método llamará OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) si el nombre de la actividad es signin/verifyState o signin/tokenExchange. Un signin/verifyState objeto puede desencadenar una invocación o signin/tokenExchange .OAuthCard

OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica para cuando los miembros distintos del bot se unan a la conversación, como la lógica de bienvenida del bot.

OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)

Invalide esta opción en una clase derivada para proporcionar lógica para cuando los miembros que no sean el bot abandonan la conversación, como la lógica adecuada del bot.

OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica específica de Message las actividades, como la lógica conversacional.

OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)

Se invoca cuando se recibe una actividad de evento del conector cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Las reacciones de mensaje corresponden al usuario que agrega un "like" o "sad", etc. (a menudo un emoji) a una actividad enviada previamente. Las reacciones de mensajes solo son compatibles con algunos canales. La actividad a la que corresponde la reacción del mensaje se indica en la propiedad replyToId. El valor de esta propiedad es el identificador de actividad de una actividad enviada previamente que se devolvía al bot como respuesta de una llamada de envío.

OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica para cuando se agregan reacciones a una actividad anterior a la conversación.

OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica para cuando se quitan las reacciones a una actividad anterior de la conversación.

OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)

Se invoca cuando el bot se envía una actividad "invoke" que tiene el nombre "application/search".

OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)

Se invoca cuando se recibe un signin/verifyState evento o signin/tokenExchange cuando se usa el comportamiento base de OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) . Si usa un OAuthPrompt, invalide este método para reenviar esto Activity al cuadro de diálogo actual. De forma predeterminada, este método no hace nada.

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Se invoca cuando se recibe un tokens/response evento cuando se usa el comportamiento base de OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) . Si usa un OAuthPrompt, invalide este método para reenviar esto Activity al cuadro de diálogo actual. De forma predeterminada, este método no hace nada.

OnTurnAsync(ITurnContext, CancellationToken)

Lo llama el adaptador (por ejemplo, un BotFrameworkAdapter) en tiempo de ejecución para procesar un elemento entrante Activity.

OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)

Invalide esto en una clase derivada para proporcionar lógica específica de Typing las actividades, como la lógica conversacional.

OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

Se invoca cuando se recibe una actividad distinta de un mensaje, una actualización de conversación o un evento cuando se usa el comportamiento base de OnTurnAsync(ITurnContext, CancellationToken) . Si se invalida, esto podría responder potencialmente a cualquiera de los otros tipos de actividad, como ContactRelationUpdate o EndOfConversation. De forma predeterminada, este método no hace nada.

Se aplica a