Поделиться через


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), если имя действия tokens/response или OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) в противном случае. Событие tokens/response может быть активировано OAuthCard.

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Вызывается при получении события, отличного от tokens/response, когда используется базовое поведение OnEventActivityAsync(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), если имя действия signin/verifyState или signin/tokenExchange. Вызов signin/verifyState или signin/tokenExchange может активироваться OAuthCard.

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)

Вызывается при получении события signin/verifyState или signin/tokenExchange при использовании базового поведения OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken). При использовании OAuthPromptпереопределите этот метод, чтобы перенаправлять этот Activity в текущее диалоговое окно. По умолчанию этот метод ничего не делает.

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Вызывается при получении события tokens/response при использовании базового поведения OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken). При использовании OAuthPromptпереопределите этот метод, чтобы перенаправлять этот Activity в текущее диалоговое окно. По умолчанию этот метод ничего не делает.

OnTurnAsync(ITurnContext, CancellationToken)

Вызывается адаптером (например, BotFrameworkAdapter) во время выполнения для обработки входящего Activity.

OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)

Переопределите это в производном классе, чтобы обеспечить логику, конкретную для Typing действий, таких как логика беседы.

OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

Вызывается при получении действия, отличного от сообщения, обновления беседы или события при использовании базового поведения OnTurnAsync(ITurnContext, CancellationToken). При переопределении это может реагировать на любой из других типов действий, таких как ContactRelationUpdate или EndOfConversation. По умолчанию этот метод ничего не делает.

Применяется к