ActivityHandler Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Se invoca cuando se recibe un evento distinto |
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 |
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 |
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Se invoca cuando se recibe un |
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. |