語言

ActivityHandler.OnMessageReactionActivityAsync 方法

定義

使用 OnTurnAsync(ITurnContext, CancellationToken) 基底行為時,從連接器接收事件活動時叫用。 訊息反應會對應至使用者,將「讚」或「悲傷」等(通常是表情符號)新增至先前傳送的活動。 只有少數通道支援訊息反應。 訊息回應所對應的活動會在 replyToId 屬性中指出。 這個屬性的值是先前傳回給 Bot 的活動活動標識碼,做為來自傳送呼叫的回應。

protected virtual System.Threading.Tasks.Task OnMessageReactionActivityAsync(Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IMessageReactionActivity> turnContext, System.Threading.CancellationToken cancellationToken);
abstract member OnMessageReactionActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IMessageReactionActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnMessageReactionActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IMessageReactionActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Protected Overridable Function OnMessageReactionActivityAsync (turnContext As ITurnContext(Of IMessageReactionActivity), cancellationToken As CancellationToken) As Task

參數

turnContext
ITurnContext<IMessageReactionActivity>

本回合的強型態上下文物件。

cancellationToken
CancellationToken

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

工作,表示要執行的工作佇列。

備註

當 OnTurnAsync(ITurnContext, CancellationToken) 方法收到訊息反應活動時,它會呼叫此方法。 如果訊息反應指出已將回應新增至訊息,則會呼叫 OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)。 如果訊息反應指出已從訊息中移除回應,則會呼叫 OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)。

在衍生類別中,覆寫此方法以新增套用至所有訊息反應活動的邏輯。 在呼叫基底類別 OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken) 方法之前,先加入邏輯以套用,然後再加進或移除邏輯。 在呼叫基類 OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken) 方法後,新增或移除邏輯後,加入套用邏輯以套用。

適用於

另請參閱