TeamsActivityHandler class

Пакет:

botbuilder

Добавлена поддержка конкретных событий и взаимодействий в Microsoft Teams.

Extends

ActivityHandler

Комментарии

Разработчики могут обрабатывать действия обновления бесед, отправленные из Microsoft Teams двумя способами:

1. Переопределение методов, начиная с on.. и не заканчивающихся ..Event() на (например, onTeamsMembersAdded()), или вместо этого
2. Передача обратных вызовов в методы, начинающиеся с on..и заканчивающиеся ...Event() на (например, onTeamsMembersAddedEvent()), чтобы соответствовать старой реализации {@see ActivityHandler}.

Разработчики должны использовать 1 или 2 выше для всех действий обновления беседы, а не # 2 и 3 для одного действия. Это означает, что разработчики должны переопределять onTeamsMembersAdded() и не использовать оба onTeamsMembersAdded() и onTeamsMembersAddedEvent().

Разработчики, желающие обрабатывать действия Invoke , должны переопределять методы, начиная с handle...() (например, handleTeamsTaskModuleFetch()).

Методы

onTeamsChannelCreatedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsChannelCreated, например при создании канала.
onTeamsChannelDeletedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsChannelDeleted, например при удалении канала.
onTeamsChannelRenamedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsChannelRenamed, например при переименовании канала.
onTeamsChannelRestoredEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsChannelRestored, например для восстановления канала.
onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для завершения собрания Teams.
onTeamsMeetingStartEvent((meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик при запуске собрания Teams.
onTeamsMembersAddedEvent((membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsMembersAdded, например, когда участники, отличные от бота, присоединяются к каналу, например логика приветствия бота.
onTeamsMembersRemovedEvent((membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsMembersRemoved, например, когда участники, отличные от бота, покидают канал, например логику "Прощай" бота.
onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик при отправке уведомления о прочтении.
onTeamsTeamArchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsTeamArchived, например для архива команды.
onTeamsTeamDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsTeamDeleted, например при удалении команды.
onTeamsTeamHardDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsTeamHardDeleted, например при жестком удалении команды.
onTeamsTeamRenamedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsTeamRenamed, например при переименовании команды.
onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsTeamRestored, например для восстановления команды.
onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Регистрирует обработчик для событий TeamsTeamUnarchived, например, когда команда не архивирована.

Наследуемые методы

onCommand(BotHandler)	Регистрирует обработчик событий действия для действия команды .
onCommandResult(BotHandler)	Регистрирует обработчик событий действия для действия CommandResult .
onConversationUpdate(BotHandler)	Регистрирует обработчик событий действия для события обновления беседы , выдаваемого для каждого входящего действия обновления беседы.
onDialog(BotHandler)	Регистрирует обработчик событий действия для события диалогового окна , выдаваемого как последнее событие для входящего действия.
onEndOfConversation(BotHandler)	Регистрирует обработчик событий действия для завершения действия общения .
onEvent(BotHandler)	Регистрирует обработчик событий действия для события события , выдаваемого для каждого входящего события.
onInstallationUpdate(BotHandler)	Регистрирует обработчик событий действия для действия installationupdate .
onInstallationUpdateAdd(BotHandler)	Регистрирует обработчик событий действия для действия installationupdate add .
onInstallationUpdateRemove(BotHandler)	Регистрирует обработчик событий действия для действия installationupdate remove .
onMembersAdded(BotHandler)	Регистрирует обработчик событий действия для события добавления участников , выдаваемого для любого входящего действия обновления диалога, включающего участников, добавленных в беседу.
onMembersRemoved(BotHandler)	Регистрирует обработчик событий действия для события удаления участников , выдаваемого для любого входящего действия обновления диалога, включающего участников, удаленных из беседы.
onMessage(BotHandler)	Регистрирует обработчик событий действия для события сообщения , выдаваемого для каждого действия входящего сообщения.
onMessageReaction(BotHandler)	Регистрирует обработчик событий действия для события реакции на сообщение , выдаваемого для каждого действия реакции на входящее сообщение.
onReactionsAdded(BotHandler)	Регистрирует обработчик событий действия для события добавления реакций , выдаваемого для любого действия реакции входящего сообщения, описывающего реакции, добавленные в сообщение.
onReactionsRemoved(BotHandler)	Регистрирует обработчик событий действия для события удаления реакций , выдаваемого для любого действия реакции на входящее сообщение, описывающего реакции, удаленные из сообщения.
onTokenResponseEvent(BotHandler)	Регистрирует обработчик событий действия для события token-response , выдаваемого для любого входящего tokens/response действия события. Они создаются в рамках потока проверки подлинности OAuth.
onTurn(BotHandler)	Регистрирует обработчик событий действия для события поворота , создаваемого для каждого входящего действия, независимо от типа.
onTyping(BotHandler)	Регистрирует обработчик событий действия для действия ввода .
onUnrecognizedActivityType(BotHandler)	Регистрирует обработчик событий действия для события нераспознанного типа действия , создаваемого для входящего действия с типом, для которого ActivityHandler не предоставляет обработчик событий.
run(TurnContext)	Вызывается для запуска процесса выброса событий.

Сведения о методе

onTeamsChannelCreatedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsChannelCreated, например при создании канала.

function onTeamsChannelCreatedEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки события создания канала Teams.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsChannelDeletedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsChannelDeleted, например при удалении канала.

function onTeamsChannelDeletedEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки события удаления канала Teams.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsChannelRenamedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsChannelRenamed, например при переименовании канала.

function onTeamsChannelRenamedEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки события переименования канала Teams.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsChannelRestoredEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsChannelRestored, например для восстановления канала.

function onTeamsChannelRestoredEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки события восстановления канала Teams.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для завершения собрания Teams.

function onTeamsMeetingEndEvent(handler: (meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов, обрабатывающий события окончания собрания.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsMeetingStartEvent((meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик при запуске собрания Teams.

function onTeamsMeetingStartEvent(handler: (meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов, обрабатывающий события начала собрания.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsMembersAddedEvent((membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsMembersAdded, например, когда участники, отличные от бота, присоединяются к каналу, например логика приветствия бота.

function onTeamsMembersAddedEvent(handler: (membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки добавленного события участниками команд.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsMembersRemovedEvent((membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsMembersRemoved, например, когда участники, отличные от бота, покидают канал, например логику "Прощай" бота.

function onTeamsMembersRemovedEvent(handler: (membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки удаленного события участников команд.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик при отправке уведомления о прочтении.

function onTeamsReadReceiptEvent(handler: (receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов, обрабатывающий события уведомления о прочтении.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsTeamArchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsTeamArchived, например для архива команды.

function onTeamsTeamArchivedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки архивного события команды.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsTeamDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsTeamDeleted, например при удалении команды.

function onTeamsTeamDeletedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки события удаления команды.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsTeamHardDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsTeamHardDeleted, например при жестком удалении команды.

function onTeamsTeamHardDeletedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки события жесткого удаления команды команд.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsTeamRenamedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsTeamRenamed, например при переименовании команды.

function onTeamsTeamRenamedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки переименованного события команды.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsTeamRestored, например для восстановления команды.

function onTeamsTeamRestoredEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки события восстановления команды.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Регистрирует обработчик для событий TeamsTeamUnarchived, например, когда команда не архивирована.

function onTeamsTeamUnarchivedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Параметры

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Обратный вызов для обработки неархивированного события команды команд.

Возвращаемое значение

this

Обещание, представляющее работу в очереди.

Сведения о наследуемом методе

onCommand(BotHandler)

Регистрирует обработчик событий действия для действия команды .

function onCommand(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Для обработки события Command используйте обработчик событий, зависящий от типа onCommand .

Наследуется от ActivityHandler.onCommand

onCommandResult(BotHandler)

Регистрирует обработчик событий действия для действия CommandResult .

function onCommandResult(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Для обработки события CommandResult используйте обработчик событий типа onCommandResult .

Наследуется от ActivityHandler.onCommandResult

onConversationUpdate(BotHandler)

Регистрирует обработчик событий действия для события обновления беседы , выдаваемого для каждого входящего действия обновления беседы.

function onConversationUpdate(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

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

Чтобы обработать, когда члены добавляются в беседу или удаляются из нее, используйте обработчики событий подтипа onMembersAdded и onMembersRemoved .

Наследуется от ActivityHandler.onConversationUpdate

onDialog(BotHandler)

Регистрирует обработчик событий действия для события диалогового окна , выдаваемого как последнее событие для входящего действия.

function onDialog(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Наследуется от ActivityHandler.onDialog

onEndOfConversation(BotHandler)

Регистрирует обработчик событий действия для завершения действия общения .

function onEndOfConversation(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Обычно это действие отправляется из skill в вызывающий объект Skill, указывающий на конец этого конкретного дочернего диалога.

Для обработки завершения диалога используйте обработчик событий, зависящий от типа onEndOfConversation .

Наследуется от ActivityHandler.onEndOfConversation

onEvent(BotHandler)

Регистрирует обработчик событий действия для события события , выдаваемого для каждого входящего события.

function onEvent(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Действия событий передают программную информацию из клиента или канала боту. Значение действия события определяется свойством имени действия, которое имеет смысл в области канала. Действия событий предназначены для переноса как интерактивной информации (например, нажатия кнопки), так и неинтерактивной (например, уведомление о том, что клиент автоматически обновляет встроенную модель речи).

Для обработки tokens/response события используйте обработчик событий подтипа onTokenResponseEvent . Для обработки других именованных событий добавьте логику в этот обработчик.

Наследуется от ActivityHandler.onEvent

onInstallationUpdate(BotHandler)

Регистрирует обработчик событий действия для действия installationupdate .

function onInstallationUpdate(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Для обработки события InstallationUpdate используйте обработчик событий типа onInstallationUpdate .

Наследуется от ActivityHandler.onInstallationUpdate

onInstallationUpdateAdd(BotHandler)

Регистрирует обработчик событий действия для действия installationupdate add .

function onInstallationUpdateAdd(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler . Для обработки события InstallationUpdateAdd используйте обработчик события типа onInstallationUpdadd .

Наследуется от ActivityHandler.onInstallationUpdateAdd

onInstallationUpdateRemove(BotHandler)

Регистрирует обработчик событий действия для действия installationupdate remove .

function onInstallationUpdateRemove(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Для обработки события InstallationUpdateRemove используйте обработчик событий для конкретного типа onInstallationUpdateRemove .

Наследуется от ActivityHandler.onInstallationUpdateRemove

onMembersAdded(BotHandler)

Регистрирует обработчик событий действия для события добавления участников , выдаваемого для любого входящего действия обновления диалога, включающего участников, добавленных в беседу.

function onMembersAdded(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Свойство membersAdded действия содержит участников, добавленных в беседу, которые могут включать бот.

Для обработки событий обновления беседы в целом используйте обработчик событий для конкретного типа onConversationUpdate .

Наследуется от ActivityHandler.onMembersAdded

onMembersRemoved(BotHandler)

Регистрирует обработчик событий действия для события удаления участников , выдаваемого для любого входящего действия обновления диалога, включающего участников, удаленных из беседы.

function onMembersRemoved(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Свойство действия membersRemoved содержит элементы, удаленные из беседы, которые могут включать бота.

Для обработки событий обновления беседы в целом используйте обработчик событий для конкретного типа onConversationUpdate .

Наследуется от ActivityHandler.onMembersRemoved

onMessage(BotHandler)

Регистрирует обработчик событий действия для события сообщения , выдаваемого для каждого действия входящего сообщения.

function onMessage(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Действия с сообщениями представляют содержимое, предназначенное для отображения в интерфейсе беседы, и может содержать текст, речь, интерактивные карточки, двоичные или неизвестные вложения. Не все действия с сообщениями содержат текст, свойство text действия может иметь значение null или undefined.

Наследуется от ActivityHandler.onMessage

onMessageReaction(BotHandler)

Регистрирует обработчик событий действия для события реакции на сообщение , выдаваемого для каждого действия реакции на входящее сообщение.

function onMessageReaction(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Действия реагирования на сообщения представляют собой реагирование на имеющееся действие сообщения в диалоге. На исходное действие ссылается свойство replyToId действия реакции на сообщение. Свойство from представляет источник реакции, например пользователя, который отреагировал на сообщение.

Чтобы обработать, когда реакции добавляются в сообщения в беседе или удаляются из них, используйте обработчики событий подтипа onReactionsAdded и onReactionsRemoved .

Наследуется от ActivityHandler.onMessageReaction

onReactionsAdded(BotHandler)

Регистрирует обработчик событий действия для события добавления реакций , выдаваемого для любого действия реакции входящего сообщения, описывающего реакции, добавленные в сообщение.

function onReactionsAdded(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Свойство activity's reactionsAdded включает одну или несколько добавленных реакций.

Для обработки событий реакции на сообщения в целом используйте обработчик событий типа onMessageReaction .

Наследуется от ActivityHandler.onReactionsAdded

onReactionsRemoved(BotHandler)

Регистрирует обработчик событий действия для события удаления реакций , выдаваемого для любого действия реакции на входящее сообщение, описывающего реакции, удаленные из сообщения.

function onReactionsRemoved(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Свойство activity's reactionsRemoved включает одну или несколько реакций, которые были удалены.

Для обработки событий реакции на сообщения в целом используйте обработчик событий типа onMessageReaction .

Наследуется от ActivityHandler.onReactionsRemoved

onTokenResponseEvent(BotHandler)

Регистрирует обработчик событий действия для события token-response , выдаваемого для любого входящего tokens/response действия события. Они создаются в рамках потока проверки подлинности OAuth.

function onTokenResponseEvent(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Свойство value действия содержит маркер пользователя.

Если бот обрабатывает проверку подлинности с помощью OAuthPrompt в диалоговом окне, то диалог должен будет получить это действие, чтобы завершить поток проверки подлинности.

Для обработки других именованных событий и событий в целом используйте обработчик событий типа onEvent .

Наследуется от ActivityHandler.onTokenResponseEvent

onTurn(BotHandler)

Регистрирует обработчик событий действия для события поворота , создаваемого для каждого входящего действия, независимо от типа.

function onTurn(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Наследуется от ActivityHandler.onTurn

onTyping(BotHandler)

Регистрирует обработчик событий действия для действия ввода .

function onTyping(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Для обработки события typeing используйте обработчик события для конкретного типа onTyping .

Наследуется от ActivityHandler.onTyping

onUnrecognizedActivityType(BotHandler)

Регистрирует обработчик событий действия для события нераспознанного типа действия , создаваемого для входящего действия с типом, для которого ActivityHandler не предоставляет обработчик событий.

function onUnrecognizedActivityType(handler: BotHandler): this

Параметры

handler

BotHandler

Обработчик событий.

Возвращаемое значение

this

Ссылка на объект ActivityHandler .

Комментарии

Не ActivityHandler определяет события для всех типов действий, определенных в схеме действий Bot Framework. Кроме того, каналы и пользовательские адаптеры могут создавать действия с типами, не указанными в схеме. Когда обработчик действия получает такое событие, он создает событие нераспознанного типа действия.

Свойство type действия содержит тип действия.

Наследуется от ActivityHandler.onUnrecognizedActivityType

run(TurnContext)

Вызывается для запуска процесса выброса событий.

function run(context: TurnContext): Promise<void>

Параметры

context

TurnContext

Объект контекста для текущего шага.

Возвращаемое значение

Promise<void>

Комментарии

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

Например:

 server.post('/api/messages', (req, res) => {
     adapter.processActivity(req, res, async (context) => {
         // Route to bot's activity logic.
         await bot.run(context);
     });
});

См. также:

• BotFrameworkAdapter.processActivity

Наследуется от ActivityHandler.run