ActivityHandler Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Реализация интерфейса IBot, предназначенная для дальнейшего подкласса.
public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
interface IBot
Public Class ActivityHandler
Implements IBot
- Наследование
-
ActivityHandler
- Производный
- Реализации
Комментарии
Производный от этого класса для подключаемого кода для обработки определенных типов действий. Можно добавить предварительно и после обработки объектов Activity путем вызова реализации базового класса из производного класса.
Конструкторы
ActivityHandler() |
Реализация интерфейса IBot, предназначенная для дальнейшего подкласса. |
Методы
CreateInvokeResponse(Object) |
Фабрика InvokeResponse, которая инициализирует текст в переданный параметр и состояние равно ОК. |
OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken) |
Вызывается при отправке ботом действия адаптивной карточки. |
OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) |
Вызывается при получении действия команды при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken). Команды — это запросы на выполнение действия и получателей обычно отвечают на одно или несколько действий commandResult. Получатели также должны явно отклонять неподдерживаемые действия команд. |
OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken) |
Вызывается при получении действия CommandResult при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken). Действия CommandResult можно использовать для обмена данными о результатах выполнения команды. |
OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Вызывается при получении действия обновления беседы из канала при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken). Действия по обновлению беседы полезны, когда речь идет о том, чтобы реагировать на добавление или удаление пользователей из беседы. Например, бот может отвечать на добавление пользователя, приветствуя пользователя. По умолчанию этот метод вызывает OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken), если какие-либо пользователи были добавлены или OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken), если какие-либо пользователи были удалены. Метод проверяет идентификатор члена таким образом, чтобы он ответил только на обновления, касающиеся членов, отличных от самого бота. |
OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику, конкретную для EndOfConversation действий, таких как логика беседы. |
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) |
Вызывается при получении действия события из соединителя при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken).
Действия событий можно использовать для взаимодействия с различными вещами.
По умолчанию этот метод вызывает OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken), если имя действия |
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Вызывается при получении события, отличного от |
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).
Вызов действий можно использовать для взаимодействия с различными вещами.
По умолчанию этот метод вызывает OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken), если имя действия |
OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику, если члены, отличные от бота, присоединяются к беседе, например логика приветствия бота. |
OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику, если члены, отличные от бота, покидают беседу, например хорошую логику бота. |
OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику, конкретную для Message действий, таких как логика беседы. |
OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику, конкретную для MessageDelete действий, таких как логика беседы. |
OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken) |
Вызывается при получении действия события из соединителя при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken). Реакции сообщений соответствуют пользователю, добавляя "как" или "грустный" и т. д. (часто эмодзи) в ранее отправленное действие. Реакции на сообщения поддерживаются только несколькими каналами. Действие, которое соответствует реакции сообщения, указано в свойстве replyToId. Значение этого свойства — это идентификатор действия ранее отправленного действия, возвращаемого боту в качестве ответа от вызова отправки. |
OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику, конкретную для MessageUpdate действий, таких как логика беседы. |
OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику при добавлении реакций на предыдущее действие в беседу. |
OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику при удалении реакций на предыдущее действие из беседы. |
OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken) |
Вызывается, когда бот отправляет действие invoke с именем application/search. |
OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) |
Вызывается при получении события |
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Вызывается при получении события |
OnTurnAsync(ITurnContext, CancellationToken) |
Вызывается адаптером (например, BotFrameworkAdapter) во время выполнения для обработки входящего Activity. |
OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken) |
Переопределите это в производном классе, чтобы обеспечить логику, конкретную для Typing действий, таких как логика беседы. |
OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken) |
Вызывается при получении действия, отличного от сообщения, обновления беседы или события при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken). При переопределении это может реагировать на любой из других типов действий, таких как ContactRelationUpdate или EndOfConversation. По умолчанию этот метод ничего не делает. |