Språk

ActivityHandler Klass

Definition

En implementation av gränssnittet IBot , avsedd för vidare underklassning.

public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
    interface IBot
Public Class ActivityHandler
Implements IBot
Arv
ActivityHandler
Härledda
Implementeringar

Kommentarer

Härled från den här klassen för att ansluta kod för att hantera vissa aktivitetstyper. För- och efterbearbetning av Activity objekt kan läggas till genom att anropa basklassimplementeringen från den härledda klassen.

Konstruktorer

Name Description
ActivityHandler()

En implementation av gränssnittet IBot , avsedd för vidare underklassning.

Metoder

Name Description
CreateInvokeResponse(Object)

En InvokeResponse fabrik som initialiserar kroppen till parametern som passerats och status lika med OK.

OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)

Anropas när roboten skickas en åtgärd för adaptivt kort kör.

OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)

Anropas när en kommandoaktivitet tas emot när basbeteendet av OnTurnAsync(ITurnContext, CancellationToken) används. Kommandon är begäranden om att utföra en åtgärd och mottagare svarar vanligtvis med en eller flera commandResult-aktiviteter. Mottagare förväntas också uttryckligen avvisa kommandoaktiviteter som inte stöds.

OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken)

Anropas när en CommandResult-aktivitet tas emot när basbeteendet av OnTurnAsync(ITurnContext, CancellationToken) används. CommandResult-aktiviteter kan användas för att kommunicera resultatet av en kommandokörning.

OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)

Anropas när en konversationsuppdateringsaktivitet tas emot från kanalen när basbeteendet för OnTurnAsync(ITurnContext, CancellationToken) används. Konversationsuppdateringsaktiviteter är användbara när det gäller att svara på användare som läggs till i eller tas bort från konversationen. En robot kan till exempel svara på en användare som läggs till genom att hälsa på användaren. Som standard anropar OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) denna metod om några användare har lagts till eller OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) om några har tagits bort. Metoden kontrollerar medlems-ID:t så att den bara svarar på uppdateringar om andra medlemmar än själva roboten.

OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken)

Överskrid detta i en härledd klass för att ge logik specifik för EndOfConversation aktiviteter, såsom konversationslogik.

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)

Anropas när en händelseaktivitet tas emot från anslutningsappen när basbeteendet för OnTurnAsync(ITurnContext, CancellationToken) används. Händelseaktiviteter kan användas för att kommunicera många olika saker. Som standard anropar OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) denna metod om aktivitetens namn är tokens/response eller OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) inte. En händelse kan utlösas av en OAuthCard.tokens/response

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Anropas när en händelse annan än tokens/response tas emot när basbeteendet för OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) används. Den här metoden kan också åsidosättas om roboten är avsedd att hantera diverse händelser. Som standard gör den här metoden ingenting.

OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Överstyr detta i en härledd klass för att ge logik specifik för InstallationUpdate aktiviteter.

OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Överstyr detta i en härledd klass för att ge logik specifik för InstallationUpdate aktiviteter med 'action' satt till 'lägg till'.

OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Överskriv detta i en härledd klass för att ge logik specifik för InstallationUpdate aktiviteter med 'action' satt till 'ta bort'.

OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)

Anropas när en anropsaktivitet tas emot från kopplaren när basbeteendet av OnTurnAsync(ITurnContext, CancellationToken) används. Anropa aktiviteter kan användas för att kommunicera många olika saker. Som standard anropar OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) denna metod om aktivitetens namn är signin/verifyState eller signin/tokenExchange. En signin/verifyState eller signin/tokenExchange anrop kan utlösas av en OAuthCard.

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

Åsidosätt detta i en härledd klass för att tillhandahålla logik för när andra medlemmar än roboten ansluter till konversationen, till exempel robotens välkomstlogik.

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

Åsidosätt detta i en härledd klass för att tillhandahålla logik för när andra medlemmar än roboten lämnar konversationen, till exempel robotens logiska logik.

OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken)

Överskrid detta i en härledd klass för att ge logik specifik för Message aktiviteter, såsom konversationslogik.

OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken)

Överskrid detta i en härledd klass för att ge logik specifik för MessageDelete aktiviteter, såsom konversationslogik.

OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)

Anropas när en händelseaktivitet tas emot från anslutningsappen när basbeteendet för OnTurnAsync(ITurnContext, CancellationToken) används. Meddelandereaktioner motsvarar att användaren lägger till en "like" eller "sad" osv. (ofta en emoji) till en tidigare skickad aktivitet. Meddelandereaktioner stöds bara av några få kanaler. Aktiviteten som meddelandereaktionen motsvarar anges i egenskapen replyToId. Värdet för den här egenskapen är aktivitets-ID för en aktivitet som tidigare skickats tillbaka till roboten som svar från ett sändningsanrop.

OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)

Överskrid detta i en härledd klass för att ge logik specifik för MessageUpdate aktiviteter, såsom konversationslogik.

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

Åsidosätt detta i en härledd klass för att ange logik för när reaktioner på en tidigare aktivitet läggs till i konversationen.

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

Åsidosätt detta i en härledd klass för att ange logik för när reaktioner på en tidigare aktivitet tas bort från konversationen.

OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)

Anropas när roboten skickas en "anropa"-aktivitet med namnet "application/search".

OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)

Anropas när en signin/verifyState eller signin/tokenExchange händelse tas emot när basbeteendet för OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) används. Om du använder en OAuthPrompt, åsidosätt denna metod för att vidarebefordra detta Activity till den aktuella dialogen. Som standard gör den här metoden ingenting.

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Anropas när en tokens/response händelse tas emot när basbeteendet av OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) används. Om du använder en OAuthPrompt, åsidosätt denna metod för att vidarebefordra detta Activity till den aktuella dialogen. Som standard gör den här metoden ingenting.

OnTurnAsync(ITurnContext, CancellationToken)

Anropas av adaptern (till exempel en BotFrameworkAdapter) vid körning för att bearbeta en inkommande Activity.

OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)

Överskrid detta i en härledd klass för att ge logik specifik för Typing aktiviteter, såsom konversationslogik.

OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

Anropas när en annan aktivitet än ett meddelande, en konversationsuppdatering eller en händelse tas emot när grundbeteendet för OnTurnAsync(ITurnContext, CancellationToken) används. Om det åsidosätts kan detta potentiellt reagera på någon av de andra aktivitetstyperna som ContactRelationUpdate eller EndOfConversation. Som standard gör den här metoden ingenting.

Gäller för