ActivityHandler 類別

定義

命名空間:

Microsoft.Bot.Builder

組件:

Microsoft.Bot.Builder.dll

套件:

Microsoft.Bot.Builder v4.22.7

IBot 介面的實作，用於進一步的子類別化。

public class ActivityHandler : Microsoft.Bot.Builder.IBot

type ActivityHandler = class
    interface IBot

Public Class ActivityHandler
Implements IBot

繼承

Object

ActivityHandler

衍生

Microsoft.Bot.Builder.SharePoint.SharePointActivityHandler

Microsoft.Bot.Builder.Teams.TeamsActivityHandler

實作

IBot

備註

衍生自這個類別，以插入程式代碼來處理特定活動類型。 您可以從衍生類別呼叫基類實作，以新增 Activity 物件的前置和後置處理。

建構函式

ActivityHandler()

IBot 介面的實作，用於進一步的子類別化。

方法

CreateInvokeResponse(Object)	InvokeResponse 處理站，將主體初始化為傳遞的參數，並將狀態等於OK。
OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)	當 Bot 傳送調適型卡片動作執行時叫用。
OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)	當使用 OnTurnAsync(ITurnContext, CancellationToken) 的基底行為時，收到命令活動時叫用。 命令是執行動作的要求，而接收者通常會以一或多個 commandResult 活動回應。 接收者也應該明確拒絕不支援的命令活動。
OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken)	使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時，收到 CommandResult 活動時叫用。 CommandResult 活動可用來傳達命令執行的結果。
OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)	使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時，從通道接收交談更新活動時叫用。 交談更新活動在回應要新增或從交談中移除的使用者時很有用。 例如，Bot 可以藉由問候用戶來回應所新增的使用者。 根據預設，如果已新增任何使用者，或已移除任何使用者 OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)，則此方法會呼叫 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)。 方法會檢查成員標識碼，使其只會回應 Bot 本身以外的成員的更新。
OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken)	覆寫衍生類別中的這個 ，以提供 EndOfConversation 活動的特定邏輯，例如交談邏輯。
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)	使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時，從連接器接收事件活動時叫用。 事件活動可用來傳達許多不同的專案。 根據預設，如果活動的名稱是 tokens/response 或 OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)，則此方法會呼叫 OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)。 OAuthCard可以觸發 tokens/response 事件。
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)	當使用 OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) 的基底行為時，收到 tokens/response 以外的事件時叫用。 如果 Bot 是要處理其他事件，可以選擇性地覆寫這個方法。 根據預設，此方法不會執行任何動作。
OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)	覆寫衍生類別中的這個 ，以提供 InstallationUpdate 活動特有的邏輯。
OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)	覆寫衍生類別中的這個 ，以提供特定邏輯給 InstallationUpdate 活動，並將 'action' 設定為 'add'。
OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)	在衍生類別中覆寫此專案，以提供 InstallationUpdate 活動的特定邏輯，並將 'action' 設定為 'remove'。
OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)	使用 OnTurnAsync(ITurnContext, CancellationToken) 的基底行為時，從連接器接收叫用活動時叫用。 叫用活動可用來傳達許多不同的專案。 根據預設，如果活動的名稱是 signin/verifyState 或 signin/tokenExchange，這個方法會呼叫 OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)。 OAuthCard可以觸發 signin/verifyState 或 signin/tokenExchange 叫用。
OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)	在衍生類別中覆寫此專案，以提供 Bot 加入交談以外的成員時的邏輯，例如 Bot 的歡迎邏輯。
OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)	在衍生類別中覆寫此專案，以在 Bot 以外的成員離開交談時提供邏輯，例如 Bot 的告別邏輯。
OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken)	覆寫衍生類別中的這個 ，以提供 Message 活動的特定邏輯，例如交談邏輯。
OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken)	覆寫衍生類別中的這個 ，以提供 MessageDelete 活動的特定邏輯，例如交談邏輯。
OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)	使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時，從連接器接收事件活動時叫用。 訊息反應會對應至使用者，將「讚」或「悲傷」等（通常是表情符號）新增至先前傳送的活動。 只有少數通道支援訊息反應。 訊息回應所對應的活動會在 replyToId 屬性中指出。 這個屬性的值是先前傳回給 Bot 的活動活動標識碼，做為來自傳送呼叫的回應。
OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)	覆寫衍生類別中的這個 ，以提供 MessageUpdate 活動的特定邏輯，例如交談邏輯。
OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)	在衍生類別中覆寫這個 ，以提供邏輯，以在將先前活動的反應新增至交談時提供邏輯。
OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)	在衍生類別中覆寫這個 ，以提供邏輯，以在對先前活動的反應從交談中移除時提供邏輯。
OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)	在傳送具有 『application/search』 名稱的「叫用」活動時叫用 Bot。
OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)	使用 OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) 的基底行為時，收到 signin/verifyState 或 signin/tokenExchange 事件時叫用。 如果使用 OAuthPrompt，請覆寫這個方法，將這個 Activity 轉送至目前的對話框。 根據預設，此方法不會執行任何動作。
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)	當使用 OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) 的基底行為時，收到 tokens/response 事件時叫用。 如果使用 OAuthPrompt，請覆寫這個方法，將這個 Activity 轉送至目前的對話框。 根據預設，此方法不會執行任何動作。
OnTurnAsync(ITurnContext, CancellationToken)	在執行時間由配接器呼叫（例如，BotFrameworkAdapter），以處理輸入 Activity。
OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)	覆寫衍生類別中的這個 ，以提供 Typing 活動的特定邏輯，例如交談邏輯。
OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)	使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時，收到訊息、交談更新或事件以外的活動時叫用。 如果覆寫，這可能會回應任何其他活動類型，例如 ContactRelationUpdate 或 EndOfConversation。 根據預設，此方法不會執行任何動作。