TeamsActivityHandler class

Paket:

botbuilder

Fügt Unterstützung für microsoft Teams-spezifische Ereignisse und Interaktionen hinzu.

Extends

ActivityHandler

Hinweise

Entwickler können unterhaltungsaktualisierungsaktivitäten, die von Microsoft Teams gesendet werden, über zwei Methoden verarbeiten:

1. Überschreiben von Methoden, die mit on.. beginnen und nicht in enden ..Event() (z. B. onTeamsMembersAdded()), oder stattdessen
2. Übergeben von Rückrufen an Methoden, die mit on..beginnen und in ...Event() enden (z. B. onTeamsMembersAddedEvent()), um mit der älteren {@see ActivityHandler}-Implementierung in Einklang zu bleiben.

Entwickler sollten entweder #1 oder #2 verwenden, oben für alle Aktivitäten für Unterhaltungsupdates und nicht # 2 und #3 für dieselbe Aktivität. Das bedeutet, entwickler sollten außer Kraft setzen onTeamsMembersAdded() und nicht sowohl als onTeamsMembersAddedEvent()auch onTeamsMembersAdded() verwenden.

Entwickler, die Invoke-Aktivitäten verarbeiten möchten, müssen Methoden ab handle...() überschreiben (z. B. handleTeamsTaskModuleFetch()).

Methoden

onTeamsChannelCreatedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsChannelCreated-Ereignisse, z. B. beim Erstellen eines Kanals.
onTeamsChannelDeletedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsChannelDeleted-Ereignisse, z. B. für das Löschen eines Kanals.
onTeamsChannelRenamedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsChannelRenamed-Ereignisse, z. B. für den Zeitpunkt der Umbenennung eines Kanals.
onTeamsChannelRestoredEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsChannelRestored-Ereignisse, z. B. für die Wiederherstellung eines Kanals.
onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für das Ende einer Teams-Besprechung.
onTeamsMeetingStartEvent((meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für den Start einer Teams-Besprechung.
onTeamsMembersAddedEvent((membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsMembersAdded-Ereignisse, z. B. für den Fall, wenn andere Mitglieder als der Bot dem Kanal beitreten, z. B. die Willkommenslogik Ihres Bots.
onTeamsMembersRemovedEvent((membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsMembersRemoved-Ereignisse, z. B. für den Zeitpunkt, wenn andere Mitglieder als der Bot den Kanal verlassen, z. B. die Good-Bye-Logik Ihres Bots.
onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für den Zeitpunkt, an den eine Lesebestätigung gesendet wird.
onTeamsTeamArchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamArchived-Ereignisse, z. B. für die Archivierung eines Teams.
onTeamsTeamDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamDeleted-Ereignisse, z. B. für das Löschen eines Teams.
onTeamsTeamHardDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamHardDeleted-Ereignisse, z. B. für den Zeitpunkt, wenn ein Team endgültig gelöscht wird.
onTeamsTeamRenamedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamRenamed-Ereignisse, z. B. für die Umbenennung eines Teams.
onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamRestored-Ereignisse, z. B. für die Wiederherstellung eines Teams.
onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamUnarchived-Ereignisse, z. B. für den Zeitpunkt, wenn ein Team nicht archiviert wird.

Geerbte Methoden

onCommand(BotHandler)	Registriert einen Aktivitätsereignishandler für die Befehlsaktivität .
onCommandResult(BotHandler)	Registriert einen Aktivitätsereignishandler für die CommandResult-Aktivität .
onConversationUpdate(BotHandler)	Registriert einen Aktivitätsereignishandler für das Unterhaltungsupdateereignis , der für jede eingehende Unterhaltungsaktualisierungsaktivität ausgegeben wird.
onDialog(BotHandler)	Registriert einen Aktivitätsereignishandler für das Dialogereignis , der als letztes Ereignis für eine eingehende Aktivität ausgegeben wird.
onEndOfConversation(BotHandler)	Registriert einen Aktivitätsereignishandler für das Ende der Konversationsaktivität .
onEvent(BotHandler)	Registriert einen Aktivitätsereignishandler für das Ereignisereignis , der für jede eingehende Ereignisaktivität ausgegeben wird.
onInstallationUpdate(BotHandler)	Registriert einen Aktivitätsereignishandler für die Aktivität installationupdate .
onInstallationUpdateAdd(BotHandler)	Registriert einen Aktivitätsereignishandler für die Aktivität installationupdate add .
onInstallationUpdateRemove(BotHandler)	Registriert einen Aktivitätsereignishandler für die Aktivität installationupdate remove .
onMembersAdded(BotHandler)	Registriert einen Aktivitätsereignishandler für das hinzugefügte Memberereignis , das für alle eingehenden Unterhaltungsaktualisierungsaktivitäten ausgegeben wird, die Mitglieder enthält, die der Unterhaltung hinzugefügt wurden.
onMembersRemoved(BotHandler)	Registriert einen Aktivitätsereignishandler für das Vom Member entfernte Ereignis, der für alle eingehenden Unterhaltungsaktualisierungsaktivitäten ausgegeben wird, die aus der Unterhaltung entfernte Mitglieder enthält.
onMessage(BotHandler)	Registriert einen Aktivitätsereignishandler für das Nachrichtenereignis , der für jede eingehende Nachrichtenaktivität ausgegeben wird.
onMessageReaction(BotHandler)	Registriert einen Aktivitätsereignishandler für das Nachrichtenreaktionsereignis , das für jede Reaktionsaktivität eingehender Nachrichten ausgegeben wird.
onReactionsAdded(BotHandler)	Registriert einen Aktivitätsereignishandler für das hinzugefügte Reaktionsereignis , das für jede eingehende Nachrichtenreaktionsaktivität ausgegeben wird, die Reaktionen beschreibt, die einer Nachricht hinzugefügt wurden.
onReactionsRemoved(BotHandler)	Registriert einen Aktivitätsereignishandler für das reaktionsferne Ereignis, das für jede eingehende Nachrichtenreaktionsaktivität ausgegeben wird, die reaktionen beschreibt, die aus einer Nachricht entfernt wurden.
onTokenResponseEvent(BotHandler)	Registriert einen Aktivitätsereignishandler für das Tokenantwortereignis , das für jede eingehende tokens/response Ereignisaktivität ausgegeben wird. Diese werden im Rahmen des OAuth-Authentifizierungsflows generiert.
onTurn(BotHandler)	Registriert einen Aktivitätsereignishandler für das Turnereignis , der unabhängig vom Typ für jede eingehende Aktivität ausgegeben wird.
onTyping(BotHandler)	Registriert einen Aktivitätsereignishandler für die Eingabeaktivität .
onUnrecognizedActivityType(BotHandler)	Registriert einen Aktivitätsereignishandler für das nicht erkannte Aktivitätstypereignis , das für eine eingehende Aktivität mit einem Typ ausgegeben wird, für den der ActivityHandler keinen Ereignishandler bereitstellt.
run(TurnContext)	Wird aufgerufen, um den Ereignisemissionsprozess zu initiieren.

Details zur Methode

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

Registriert einen Handler für TeamsChannelCreated-Ereignisse, z. B. beim Erstellen eines Kanals.

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

Parameter

handler

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

Ein Rückruf, um das vom Teams-Kanal erstellte Ereignis zu behandeln.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsChannelDeleted-Ereignisse, z. B. für das Löschen eines Kanals.

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

Parameter

handler

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

Ein Rückruf, um das gelöschte Ereignis des Teams-Kanals zu behandeln.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsChannelRenamed-Ereignisse, z. B. für den Zeitpunkt der Umbenennung eines Kanals.

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

Parameter

handler

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

Ein Rückruf, um das umbenannte Ereignis des Teams-Kanals zu behandeln.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsChannelRestored-Ereignisse, z. B. für die Wiederherstellung eines Kanals.

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

Parameter

handler

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

Ein Rückruf zum Behandeln des wiederhergestellten Teams-Kanalereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für das Ende einer Teams-Besprechung.

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

Parameter

handler

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

Ein Rückruf, der Besprechungsendeereignisse behandelt.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für den Start einer Teams-Besprechung.

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

Parameter

handler

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

Ein Rückruf, der Besprechungsstartereignisse behandelt.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsMembersAdded-Ereignisse, z. B. für den Fall, wenn andere Mitglieder als der Bot dem Kanal beitreten, z. B. die Willkommenslogik Ihres Bots.

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

Parameter

handler

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

Ein Rückruf, um das hinzugefügte Ereignis von Teams-Mitgliedern zu behandeln.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsMembersRemoved-Ereignisse, z. B. für den Zeitpunkt, wenn andere Mitglieder als der Bot den Kanal verlassen, z. B. die Good-Bye-Logik Ihres Bots.

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

Parameter

handler

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

Ein Rückruf, um das Ereignis zu behandeln, das von Teams-Mitgliedern entfernt wurde.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für den Zeitpunkt, an den eine Lesebestätigung gesendet wird.

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

Parameter

handler

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

Ein Rückruf, der Lesebestätigungsereignisse verarbeitet.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsTeamArchived-Ereignisse, z. B. für die Archivierung eines Teams.

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

Parameter

handler

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

Ein Rückruf zum Behandeln des archivierten Teams-Ereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsTeamDeleted-Ereignisse, z. B. für das Löschen eines Teams.

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

Parameter

handler

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

Ein Rückruf zum Behandeln des teams team deleted-Ereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsTeamHardDeleted-Ereignisse, z. B. für den Zeitpunkt, wenn ein Team endgültig gelöscht wird.

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

Parameter

handler

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

Ein Rückruf, um das hart gelöschte Ereignis des Teams-Teams zu behandeln.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsTeamRenamed-Ereignisse, z. B. für die Umbenennung eines Teams.

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

Parameter

handler

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

Ein Rückruf zum Behandeln des umbenannten Teams-Ereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsTeamRestored-Ereignisse, z. B. für die Wiederherstellung eines Teams.

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

Parameter

handler

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

Ein Rückruf zum Behandeln des wiederhergestellten Teams-Teams-Ereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

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

Registriert einen Handler für TeamsTeamUnarchived-Ereignisse, z. B. für den Zeitpunkt, wenn ein Team nicht archiviert wird.

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

Parameter

handler

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

Ein Rückruf zum Behandeln des nicht archivierten Teams-Ereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeit in der Warteschlange darstellt.

Details zur geerbten Methode

onCommand(BotHandler)

Registriert einen Aktivitätsereignishandler für die Befehlsaktivität .

function onCommand(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Verwenden Sie zum Behandeln eines Command-Ereignisses den typspezifischen OnCommand-Ereignishandler .

Geerbt von ActivityHandler.onCommand

onCommandResult(BotHandler)

Registriert einen Aktivitätsereignishandler für die CommandResult-Aktivität .

function onCommandResult(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Verwenden Sie zum Behandeln eines CommandResult-Ereignisses den typspezifischen OnCommandResult-Ereignishandler .

Geerbt von ActivityHandler.onCommandResult

onConversationUpdate(BotHandler)

Registriert einen Aktivitätsereignishandler für das Unterhaltungsupdateereignis , der für jede eingehende Unterhaltungsaktualisierungsaktivität ausgegeben wird.

function onConversationUpdate(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Unterhaltungsaktualisierungsaktivitäten beschreiben Änderungen an den Metadaten einer Unterhaltung, z. B. Titel, Teilnehmer oder andere kanalspezifische Informationen.

Verwenden Sie die Ereignishandler onMembersAdded und onMembersRemoved , um zu behandeln, wann Member zur Unterhaltung hinzugefügt oder aus dieser entfernt werden.

Geerbt von ActivityHandler.onConversationUpdate

onDialog(BotHandler)

Registriert einen Aktivitätsereignishandler für das Dialogereignis , der als letztes Ereignis für eine eingehende Aktivität ausgegeben wird.

function onDialog(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Geerbt von ActivityHandler.onDialog

onEndOfConversation(BotHandler)

Registriert einen Aktivitätsereignishandler für das Ende der Konversationsaktivität .

function onEndOfConversation(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Diese Aktivität wird in der Regel von einem Skill an einen Skill-Aufrufer gesendet, der das Ende dieser bestimmten untergeordneten Unterhaltung angibt.

Verwenden Sie zum Behandeln eines Unterhaltungsendes den typspezifischen OnEndOfConversation-Ereignishandler .

Geerbt von ActivityHandler.onEndOfConversation

onEvent(BotHandler)

Registriert einen Aktivitätsereignishandler für das Ereignisereignis , der für jede eingehende Ereignisaktivität ausgegeben wird.

function onEvent(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Ereignisaktivitäten (event) kommunizieren programmgesteuerte Informationen von einem Client oder Kanal an einen Bot. Die Bedeutung einer Ereignisaktivität wird durch die name-Eigenschaft der Aktivität definiert, die im Bereich eines Kanals von Bedeutung ist. Ereignisaktivitäten sind sowohl für interaktive Informationen (z.B. Klicks auf Schaltflächen) als auch für nicht interaktive Informationen (z.B. eine Benachrichtigung für einen Client zur automatischen Aktualisierung eines eingebetteten Sprachmodells) vorgesehen.

Verwenden Sie zum Behandeln eines tokens/response Ereignisereignisses den Untertypereignishandler onTokenResponseEvent . Um andere benannte Ereignisse zu behandeln, fügen Sie diesem Handler Logik hinzu.

Geerbt von ActivityHandler.onEvent

onInstallationUpdate(BotHandler)

Registriert einen Aktivitätsereignishandler für die Aktivität installationupdate .

function onInstallationUpdate(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Verwenden Sie zum Behandeln eines InstallationsUpdate-Ereignisses den typspezifischen OnInstallationUpdate-Ereignishandler .

Geerbt von ActivityHandler.onInstallationUpdate

onInstallationUpdateAdd(BotHandler)

Registriert einen Aktivitätsereignishandler für die Aktivität installationupdate add .

function onInstallationUpdateAdd(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt . Verwenden Sie zum Behandeln eines InstallationsUpdateAdd-Ereignisses den typspezifischen Ereignishandler onInstallationUpdateAdd .

Geerbt von ActivityHandler.onInstallationUpdateAdd

onInstallationUpdateRemove(BotHandler)

Registriert einen Aktivitätsereignishandler für die Aktivität installationupdate remove .

function onInstallationUpdateRemove(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Verwenden Sie zum Behandeln eines InstallationsUpdateRemove-Ereignisses den typspezifischen Ereignishandler onInstallationUpdateRemove .

Geerbt von ActivityHandler.onInstallationUpdateRemove

onMembersAdded(BotHandler)

Registriert einen Aktivitätsereignishandler für das hinzugefügte Memberereignis , das für alle eingehenden Unterhaltungsaktualisierungsaktivitäten ausgegeben wird, die Mitglieder enthält, die der Unterhaltung hinzugefügt wurden.

function onMembersAdded(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Die membersAdded-Eigenschaft der Aktivität enthält die Mitglieder, die der Konversation hinzugefügt wurden, einschließlich des Bots.

Verwenden Sie den typspezifischen Ereignishandler onConversationUpdate, um Unterhaltungsaktualisierungsereignisse im Allgemeinen zu behandeln.

Geerbt von ActivityHandler.onMembersAdded

onMembersRemoved(BotHandler)

Registriert einen Aktivitätsereignishandler für das Vom Member entfernte Ereignis, der für alle eingehenden Unterhaltungsaktualisierungsaktivitäten ausgegeben wird, die aus der Unterhaltung entfernte Mitglieder enthält.

function onMembersRemoved(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Die membersRemoved-Eigenschaft der Aktivität enthält die Elemente, die aus der Unterhaltung entfernt wurden, einschließlich des Bots.

Verwenden Sie den typspezifischen Ereignishandler onConversationUpdate, um Unterhaltungsaktualisierungsereignisse im Allgemeinen zu behandeln.

Geerbt von ActivityHandler.onMembersRemoved

onMessage(BotHandler)

Registriert einen Aktivitätsereignishandler für das Nachrichtenereignis , der für jede eingehende Nachrichtenaktivität ausgegeben wird.

function onMessage(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Nachrichtenaktivitäten stellen Inhalte dar, die innerhalb einer Konversationsoberfläche angezeigt werden sollen, und können Text, Sprache, interaktive Karten und binäre oder unbekannte Anlagen enthalten. Nicht alle Nachrichtenaktivitäten enthalten Text. Die Texteigenschaft der Aktivität kann oder undefinedseinnull.

Geerbt von ActivityHandler.onMessage

onMessageReaction(BotHandler)

Registriert einen Aktivitätsereignishandler für das Nachrichtenreaktionsereignis , das für jede Reaktionsaktivität eingehender Nachrichten ausgegeben wird.

function onMessageReaction(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Aktivitäten zur Antwort auf eine Nachricht (messageReaction) stellen eine soziale Interaktion mit einer vorhandenen Nachrichtenaktivität innerhalb einer Konversation dar. Auf die ursprüngliche Aktivität wird durch die replyToId-Eigenschaft der Nachrichtenreaktionsaktivität verwiesen. Die from-Eigenschaft stellt die Quelle der Reaktion dar, z. B. den Benutzer, der auf die Nachricht reagiert hat.

Verwenden Sie die Ereignishandler onReactionsAdded und onReactionsRemoved , um zu behandeln, wenn Reaktionen zu Nachrichten in der Unterhaltung hinzugefügt oder aus diesen entfernt werden.

Geerbt von ActivityHandler.onMessageReaction

onReactionsAdded(BotHandler)

Registriert einen Aktivitätsereignishandler für das hinzugefügte Reaktionsereignis , das für jede eingehende Nachrichtenreaktionsaktivität ausgegeben wird, die Reaktionen beschreibt, die einer Nachricht hinzugefügt wurden.

function onReactionsAdded(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Die Reaktion der AktivitätAdded-Eigenschaft enthält mindestens eine Reaktion, die hinzugefügt wurde.

Um Nachrichtenreaktionsereignisse im Allgemeinen zu behandeln, verwenden Sie den typspezifischen OnMessageReaction-Ereignishandler .

Geerbt von ActivityHandler.onReactionsAdded

onReactionsRemoved(BotHandler)

Registriert einen Aktivitätsereignishandler für das reaktionsferne Ereignis, das für jede eingehende Nachrichtenreaktionsaktivität ausgegeben wird, die reaktionen beschreibt, die aus einer Nachricht entfernt wurden.

function onReactionsRemoved(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Die Reaktion der AktivitätRemoved-Eigenschaft enthält mindestens eine Reaktion, die entfernt wurde.

Um Nachrichtenreaktionsereignisse im Allgemeinen zu behandeln, verwenden Sie den typspezifischen OnMessageReaction-Ereignishandler .

Geerbt von ActivityHandler.onReactionsRemoved

onTokenResponseEvent(BotHandler)

Registriert einen Aktivitätsereignishandler für das Tokenantwortereignis , das für jede eingehende tokens/response Ereignisaktivität ausgegeben wird. Diese werden im Rahmen des OAuth-Authentifizierungsflows generiert.

function onTokenResponseEvent(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Die value-Eigenschaft der Aktivität enthält das Benutzertoken.

Wenn Ihr Bot die Authentifizierung mithilfe eines OAuthPrompts in einem Dialogfeld verarbeitet, muss das Dialogfeld diese Aktivität empfangen, um den Authentifizierungsfluss abzuschließen.

Um andere benannte Ereignisse und Ereignisereignisse im Allgemeinen zu behandeln, verwenden Sie den typspezifischen onEvent-Ereignishandler .

Geerbt von ActivityHandler.onTokenResponseEvent

onTurn(BotHandler)

Registriert einen Aktivitätsereignishandler für das Turnereignis , der unabhängig vom Typ für jede eingehende Aktivität ausgegeben wird.

function onTurn(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Geerbt von ActivityHandler.onTurn

onTyping(BotHandler)

Registriert einen Aktivitätsereignishandler für die Eingabeaktivität .

function onTyping(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Verwenden Sie zum Behandeln eines Typingereignisses den typspezifischen Ereignishandler onTyping .

Geerbt von ActivityHandler.onTyping

onUnrecognizedActivityType(BotHandler)

Registriert einen Aktivitätsereignishandler für das nicht erkannte Aktivitätstypereignis , das für eine eingehende Aktivität mit einem Typ ausgegeben wird, für den der ActivityHandler keinen Ereignishandler bereitstellt.

function onUnrecognizedActivityType(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt .

Hinweise

Die ActivityHandler definiert keine Ereignisse für alle Aktivitätstypen, die im Bot Framework-Aktivitätsschema definiert sind. Darüber hinaus können Kanäle und benutzerdefinierte Adapter Aktivitäten mit Typen erstellen, die nicht im Schema enthalten sind. Wenn der Aktivitätshandler ein solches Ereignis empfängt, gibt er ein nicht erkanntes Aktivitätstypereignis aus.

Die Type-Eigenschaft der Aktivität enthält den Aktivitätstyp.

Geerbt von ActivityHandler.onUnrecognizedActivityType

run(TurnContext)

Wird aufgerufen, um den Ereignisemissionsprozess zu initiieren.

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

Parameter

context

TurnContext

Das Kontextobjekt für den aktuellen Turn.

Gibt zurück

Promise<void>

Hinweise

In der Regel stellen Sie diese Methode als Funktionshandler bereit, den der Adapter aufruft, um die Logik des Bots auszuführen, nachdem die empfangene Aktivität vom Adapter vorverarbeitet und über eine beliebige Middleware weitergeleitet wurde.

Beispiel:

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

Weitere Informationen

• BotFrameworkAdapter.processActivity

Geerbt von ActivityHandler.run