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 behandeln, die von Microsoft Teams über zwei Methoden gesendet werden:

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

Entwickler sollten entweder "#1" oder "#2" verwenden, vor allem für alle Unterhaltungsaktualisierungsaktivitäten und nicht sowohl #2 als auch #3 für dieselbe Aktivität. Dies bedeutet, dass Entwickler onTeamsMembersAdded() außer Kraft setzen und nicht sowohl onTeamsMembersAdded() als auch onTeamsMembersAddedEvent()verwenden sollten.

Entwickler, die Aufrufaktivitäten behandeln möchten, müssen Methoden außer Kraft setzen, beginnend mit handle...() (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. für den Zeitpunkt der Erstellung 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 den Zeitpunkt, an dem ein Kanal wiederhergestellt wird.
onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für den Zeitpunkt, an dem eine Teams-Besprechung endet.
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. wenn Mitglieder außer dem 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. wenn Mitglieder außer dem Bot den Kanal verlassen, z. B. die Gute-Bye-Logik Ihres Bots.
onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für den Zeitpunkt, zu dem 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 das Archivieren 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, an dem 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 den Zeitpunkt der Umbenennung eines Teams.
onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamRestored-Ereignisse, z. B. für den Zeitpunkt, an dem ein Team wiederhergestellt wird.
onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registriert einen Handler für TeamsTeamUnarchived-Ereignisse, z. B. für das Aufheben der Archivierung eines Teams.

Geerbte Methoden

onCommand(BotHandler)	Registriert einen Aktivitätsereignishandler für den Befehl Aktivität.
onCommandResult(BotHandler)	Registriert einen Aktivitätsereignishandler für die CommandResult--Aktivität.
onConversationUpdate(BotHandler)	Registriert einen Aktivitätsereignishandler für das Unterhaltungsupdate Ereignis, das für jede Aktivitätsaktualisierung eingehender Unterhaltungen ausgegeben wird.
onDialog(BotHandler)	Registriert einen Aktivitätsereignishandler für das Dialogfeld Ereignis, das als letztes Ereignis für eine eingehende Aktivität ausgegeben wird.
onEndOfConversation(BotHandler)	Registriert einen Aktivitätsereignishandler für das Ende der Unterhaltung Aktivität.
onEvent(BotHandler)	Registriert einen Aktivitätsereignishandler für das Ereignis Ereignis, das für jede eingehende Ereignisaktivität ausgegeben wird.
onInstallationUpdate(BotHandler)	Registriert einen Aktivitätsereignishandler für das installationupdate Aktivität.
onInstallationUpdateAdd(BotHandler)	Registriert einen Aktivitätsereignishandler für das Installationsupdates, um Aktivität hinzuzufügen.
onInstallationUpdateRemove(BotHandler)	Registriert einen Aktivitätsereignishandler für das installationupdate entfernen Aktivität.
onMembersAdded(BotHandler)	Registriert einen Aktivitätsereignishandler für die Mitglieder, die Ereignis hinzugefügt wurden, ausgegeben für alle Aktivitätsaktualisierungen eingehender Unterhaltungen, die Mitglieder enthalten, die der Unterhaltung hinzugefügt wurden.
onMembersRemoved(BotHandler)	Registriert einen Aktivitätsereignishandler für die Mitglieder, die Ereignis entfernt wurden, ausgelassen für alle Aktivitätsaktualisierungen eingehender Unterhaltungen, die Mitglieder enthalten, die aus der Unterhaltung entfernt wurden.
onMessage(BotHandler)	Registriert einen Aktivitätsereignishandler für die Nachricht Ereignis, die für jede aktivität eingehende Nachricht ausgegeben wird.
onMessageReaction(BotHandler)	Registriert einen Aktivitätsereignishandler für die Nachrichtenreaktion Ereignis, die für jede Eingehende Nachrichtenreaktionsaktivität ausgegeben wird.
onReactionsAdded(BotHandler)	Registriert einen Aktivitätsereignishandler für die Reaktionen, die Ereignis hinzugefügt wurden, ausgelassen für jede Aktivität eingehender Nachrichtenreaktionen, die Reaktionen beschreiben, die einer Nachricht hinzugefügt werden.
onReactionsRemoved(BotHandler)	Registriert einen Aktivitätsereignishandler für die entfernten Reaktionen Ereignis, die für alle aktivitäts eingehenden Nachrichtenreaktionen ausgegeben werden, die Reaktionen beschreiben, die aus einer Nachricht entfernt werden.
onTokenResponseEvent(BotHandler)	Registriert einen Aktivitätsereignishandler für das Tokenantwort--Ereignis, das für eingehende tokens/response Ereignisaktivität ausgegeben wird. Diese werden als Teil des OAuth-Authentifizierungsflusses generiert.
onTurn(BotHandler)	Registriert einen Aktivitätsereignishandler für das turn-Ereignis, das für jede eingehende Aktivität ausgegeben wird, unabhängig vom Typ.
onTyping(BotHandler)	Registriert einen Aktivitätsereignishandler für die Eingabe Aktivität.
onUnrecognizedActivityType(BotHandler)	Registriert einen Aktivitätsereignishandler für den nicht erkannten Aktivitätstyp Ereignis, 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 Ereignisemissionensprozess 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. für den Zeitpunkt der Erstellung 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 zum Behandeln des erstellten Teams-Kanalereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange 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 zum Behandeln des gelöschten Teams-Kanalereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange 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 zum Behandeln des umbenannten Teams-Kanalereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsChannelRestored-Ereignisse, z. B. für den Zeitpunkt, an dem ein Kanal wiederhergestellt wird.

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 Ereignisses des Teams-Kanals.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für den Zeitpunkt, an dem eine Teams-Besprechung endet.

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 Arbeitswarteschlange 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 Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsMembersAdded-Ereignisse, z. B. wenn Mitglieder außer dem 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 zur Behandlung der hinzugefügten Teams-Mitglieder.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsMembersRemoved-Ereignisse, z. B. wenn Mitglieder außer dem Bot den Kanal verlassen, z. B. die Gute-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 zur Behandlung der entfernten Teams-Mitglieder.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für den Zeitpunkt, zu dem 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 behandelt.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsTeamArchived-Ereignisse, z. B. für das Archivieren 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 Arbeitswarteschlange 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 gelöschten Teams-Ereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsTeamHardDeleted-Ereignisse, z. B. für den Zeitpunkt, an dem 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 zum Behandeln des endgültig gelöschten Ereignisses des Teams-Teams.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsTeamRenamed-Ereignisse, z. B. für den Zeitpunkt der 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 zur Behandlung des umbenannten Teams-Ereignisses.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsTeamRestored-Ereignisse, z. B. für den Zeitpunkt, an dem ein Team wiederhergestellt wird.

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 Ereignisses des Teams-Teams.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

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

Registriert einen Handler für TeamsTeamUnarchived-Ereignisse, z. B. für das Aufheben der Archivierung eines Teams.

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 Ereignisses des Teams-Teams.

Gibt zurück

this

Eine Zusage, die die Arbeitswarteschlange darstellt.

Details zur geerbten Methode

onCommand(BotHandler)

Registriert einen Aktivitätsereignishandler für den Befehl Aktivitä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 onCommand- typspezifischen Ereignishandler.

von ActivityHandler.onCommand geerbt

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 onCommandResult- typspezifischen Ereignishandler.

von ActivityHandler.onCommandResult geerbt

onConversationUpdate(BotHandler)

Registriert einen Aktivitätsereignishandler für das Unterhaltungsupdate Ereignis, das für jede Aktivitätsaktualisierung eingehender Unterhaltungen 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 "onMembersAdded"- und "onMembersRemoved" Untertypereignishandler, um zu behandeln, wann Mitglieder der Unterhaltung hinzugefügt oder daraus entfernt werden.

von ActivityHandler.onConversationUpdate geerbt

onDialog(BotHandler)

Registriert einen Aktivitätsereignishandler für das Dialogfeld Ereignis, das 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.

von ActivityHandler.onDialog geerbt

onEndOfConversation(BotHandler)

Registriert einen Aktivitätsereignishandler für das Ende der Unterhaltung Aktivitä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 einer Fähigkeit an einen Skill-Anrufer gesendet, der das Ende dieser bestimmten Kindunterhaltung angibt.

Verwenden Sie zum Behandeln eines Unterhaltungsendes den onEndOfConversation typspezifischen Ereignishandler.

von ActivityHandler.onEndOfConversation geerbt

onEvent(BotHandler)

Registriert einen Aktivitätsereignishandler für das Ereignis Ereignis, das 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 kommunizieren programmgesteuerte Informationen von einem Client oder Kanal an einen Bot. Die Bedeutung einer Ereignisaktivität wird durch den Namen der Aktivität Eigenschaft definiert, die innerhalb des Bereichs eines Kanals sinnvoll ist. Ereignisaktivitäten sind so konzipiert, dass sowohl interaktive Informationen (z. B. Schaltflächenklicks) als auch nicht interaktive Informationen (z. B. eine Benachrichtigung eines Clients, die automatisch ein eingebettetes Sprachmodell aktualisiert) übertragen werden.

Verwenden Sie den "onTokenResponseEvent" Untertypereignishandler, um ein tokens/response Ereignisereignis zu behandeln. Um andere benannte Ereignisse zu behandeln, fügen Sie diesem Handler Logik hinzu.

von ActivityHandler.onEvent geerbt

onInstallationUpdate(BotHandler)

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

function onInstallationUpdate(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt.

Hinweise

Um ein InstallationUpdate-Ereignis zu behandeln, verwenden Sie den onInstallationUpdate typspezifischen Ereignishandler.

von ActivityHandler.onInstallationUpdate geerbt

onInstallationUpdateAdd(BotHandler)

Registriert einen Aktivitätsereignishandler für das Installationsupdates, um Aktivität hinzuzufügen.

function onInstallationUpdateAdd(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt. Um ein InstallationUpdateAdd-Ereignis zu behandeln, verwenden Sie den onInstallationUpdateAdd typspezifischen Ereignishandler.

von ActivityHandler.onInstallationUpdateAdd geerbt

onInstallationUpdateRemove(BotHandler)

Registriert einen Aktivitätsereignishandler für das installationupdate entfernen Aktivität.

function onInstallationUpdateRemove(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt.

Hinweise

Um ein InstallationUpdateRemove-Ereignis zu behandeln, verwenden Sie den onInstallationUpdateRemove typspezifischen Ereignishandler.

von ActivityHandler.onInstallationUpdateRemove geerbt

onMembersAdded(BotHandler)

Registriert einen Aktivitätsereignishandler für die Mitglieder, die Ereignis hinzugefügt wurden, ausgegeben für alle Aktivitätsaktualisierungen eingehender Unterhaltungen, die Mitglieder enthalten, 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 Unterhaltung hinzugefügt wurden, die den Bot enthalten können.

Verwenden Sie zum Behandeln von Unterhaltungsaktualisierungsereignissen im Allgemeinen den onConversationUpdate typspezifischen Ereignishandler.

geerbt von ActivityHandler.onMembersAdded

onMembersRemoved(BotHandler)

Registriert einen Aktivitätsereignishandler für die Mitglieder, die Ereignis entfernt wurden, ausgelassen für alle Aktivitätsaktualisierungen eingehender Unterhaltungen, die Mitglieder enthalten, die aus der Unterhaltung entfernt wurden.

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 Mitglieder, die aus der Unterhaltung entfernt wurden, die den Bot enthalten können.

Verwenden Sie zum Behandeln von Unterhaltungsaktualisierungsereignissen im Allgemeinen den onConversationUpdate typspezifischen Ereignishandler.

von ActivityHandler.onMembersRemoved geerbt

onMessage(BotHandler)

Registriert einen Aktivitätsereignishandler für die Nachricht Ereignis, die für jede aktivität eingehende Nachricht 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 in einer Unterhaltungsschnittstelle angezeigt werden sollen, und können Text, Sprache, interaktive Karten und binäre oder unbekannte Anlagen enthalten. Nicht alle Nachrichtenaktivitäten enthalten Text, der Text der Aktivität Eigenschaft kann null oder undefinedwerden.

von ActivityHandler.onMessage geerbt

onMessageReaction(BotHandler)

Registriert einen Aktivitätsereignishandler für die Nachrichtenreaktion Ereignis, die für jede Eingehende Nachrichtenreaktionsaktivität ausgegeben wird.

function onMessageReaction(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt.

Hinweise

Nachrichtenreaktionsaktivitäten stellen eine soziale Interaktion für eine vorhandene Nachrichtenaktivität innerhalb einer Unterhaltung dar. Die ursprüngliche Aktivität wird durch die replyToId-Eigenschaft der Nachrichtenreaktionsaktivität verwiesen. Die von-Eigenschaft stellt die Quelle der Reaktion dar, z. B. der Benutzer, der auf die Nachricht reagiert hat.

Verwenden Sie die "onReactionsAdded"- und "onReactionsRemoved" Untertyp-Ereignishandlern, um zu behandeln, wann Reaktionen zu Nachrichten in der Unterhaltung hinzugefügt oder aus diesen entfernt werden.

von ActivityHandler.onMessageReaction geerbt

onReactionsAdded(BotHandler)

Registriert einen Aktivitätsereignishandler für die Reaktionen, die Ereignis hinzugefügt wurden, ausgelassen für jede Aktivität eingehender Nachrichtenreaktionen, die Reaktionen beschreiben, die einer Nachricht hinzugefügt werden.

function onReactionsAdded(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt.

Hinweise

Die Reaktionen Der Eigenschaft der Aktivität umfasst eine oder mehrere hinzugefügte Reaktionen.

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

von ActivityHandler.onReactionsAdded geerbt

onReactionsRemoved(BotHandler)

Registriert einen Aktivitätsereignishandler für die entfernten Reaktionen Ereignis, die für alle aktivitäts eingehenden Nachrichtenreaktionen ausgegeben werden, die Reaktionen beschreiben, die aus einer Nachricht entfernt werden.

function onReactionsRemoved(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt.

Hinweise

Die Reaktionen der AktivitätRemoved Eigenschaft umfasst eine oder mehrere Reaktionen, die entfernt wurden.

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

von ActivityHandler.onReactionsRemoved geerbt

onTokenResponseEvent(BotHandler)

Registriert einen Aktivitätsereignishandler für das Tokenantwort--Ereignis, das für eingehende tokens/response Ereignisaktivität ausgegeben wird. Diese werden als Teil des OAuth-Authentifizierungsflusses generiert.

function onTokenResponseEvent(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt.

Hinweise

Der Wert der Aktivität Eigenschaft enthält das Benutzertoken.

Wenn Ihr Bot die Authentifizierung mithilfe eines OAuthPrompt- 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 onEvent- typspezifischen Ereignishandler.

von ActivityHandler.onTokenResponseEvent geerbt

onTurn(BotHandler)

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

function onTurn(handler: BotHandler): this

Parameter

handler

BotHandler

Der Ereignishandler.

Gibt zurück

this

Ein Verweis auf das ActivityHandler-Objekt.

von ActivityHandler.onTurn geerbt

onTyping(BotHandler)

Registriert einen Aktivitätsereignishandler für die Eingabe Aktivitä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 Typing-Ereignisses den "onTyping" typspezifischen Ereignishandlers.

von ActivityHandler.onTyping geerbt

onUnrecognizedActivityType(BotHandler)

Registriert einen Aktivitätsereignishandler für den nicht erkannten Aktivitätstyp Ereignis, 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 Activity Schemadefiniert 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.

Der Typ Eigenschaft der Aktivität enthält den Aktivitätstyp.

von ActivityHandler.onUnrecognizedActivityType geerbt

run(TurnContext)

Wird aufgerufen, um den Ereignisemissionensprozess zu initiieren.

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

Parameter

context

TurnContext

Das Kontextobjekt für die aktuelle Drehung.

Gibt zurück

Promise<void>

Hinweise

In der Regel würden Sie diese Methode als Funktionshandler bereitstellen, den der Adapter aufruft, um die Logik des Bots auszuführen, nachdem die empfangene Aktivität vom Adapter vorverarbeitet und durch jede Middleware weitergeleitet wurde.

Zum Beispiel:

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

Siehe auch

• BotFrameworkAdapter.processActivity

geerbt von ActivityHandler.run