TeamsActivityHandler class

Pacchetto:

botbuilder

Aggiunge il supporto per eventi e interazioni specifici di Microsoft Teams.

Extends

ActivityHandler

Commenti

Gli sviluppatori possono gestire le attività di Conversation Update inviate da Microsoft Teams tramite due metodi:

1. L'override dei metodi che iniziano con on.. e non terminano in ..Event() (ad esempio, onTeamsMembersAdded()) o
2. Passaggio di callback ai metodi a partire da on..e che terminano con ...Event() (ad esempio, onTeamsMembersAddedEvent()), per rimanere in linea con l'implementazione precedente di {@see ActivityHandler}.

Gli sviluppatori devono usare #1 o #2, sopra per tutte le attività di Conversation Update e non sia #2 che #3 per la stessa attività. Ciò significa che gli sviluppatori devono eseguire l'override di onTeamsMembersAdded() e non usare sia onTeamsMembersAdded() che onTeamsMembersAddedEvent().

Gli sviluppatori che vogliono gestire le attività Invoke devono metodi di override a partire da handle...() (ad esempio, handleTeamsTaskModuleFetch()).

Metodi

onTeamsChannelCreatedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsChannelCreated, ad esempio quando viene creato un canale.
onTeamsChannelDeletedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsChannelDeleted, ad esempio quando viene eliminato un canale.
onTeamsChannelRenamedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsChannelRenamed, ad esempio quando viene rinominato un canale.
onTeamsChannelRestoredEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsChannelRestored, ad esempio quando viene ripristinato un canale.
onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per quando termina una riunione di Teams.
onTeamsMeetingStartEvent((meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per all'avvio di una riunione di Teams.
onTeamsMembersAddedEvent((membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsMembersAdded, ad esempio quando i membri diversi dal bot si uniscono al canale, ad esempio la logica di benvenuto del bot.
onTeamsMembersRemovedEvent((membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsMembersRemoved, ad esempio quando i membri diversi dal bot lasciano il canale, ad esempio la logica good-bye del bot.
onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per quando viene inviata una ricevuta di lettura.
onTeamsTeamArchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsTeamArchived, ad esempio quando un team viene archiviato.
onTeamsTeamDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsTeamDeleted, ad esempio quando un team viene eliminato.
onTeamsTeamHardDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsTeamHardDeleted, ad esempio quando un team viene eliminato definitivamente.
onTeamsTeamRenamedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsTeamRenamed, ad esempio quando un team viene rinominato.
onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsTeamRestored, ad esempio quando un team viene ripristinato.
onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un gestore per gli eventi TeamsTeamUnarchived, ad esempio quando un team non è archiviato.

Metodi ereditati

onCommand(BotHandler)	Registra un gestore eventi attività per l'attività comando.
onCommandResult(BotHandler)	Registra un gestore eventi attività per l'attività CommandResult.
onConversationUpdate(BotHandler)	Registra un gestore eventi attività per l'evento di aggiornamento della conversazione , generato per ogni attività di aggiornamento della conversazione in ingresso.
onDialog(BotHandler)	Registra un gestore eventi di attività per la finestra di dialogo evento, generato come ultimo evento per un'attività in ingresso.
onEndOfConversation(BotHandler)	Registra un gestore eventi di attività per la fine della conversazione 'attività di.
onEvent(BotHandler)	Registra un gestore eventi di attività per l'evento evento, generato per ogni attività dell'evento in ingresso.
onInstallationUpdate(BotHandler)	Registra un gestore eventi attività per l'attività installationupdate.
onInstallationUpdateAdd(BotHandler)	Registra un gestore eventi di attività per l''attività add.
onInstallationUpdateRemove(BotHandler)	Registra un gestore eventi di attività per l''operazione di rimozione'attività.
onMembersAdded(BotHandler)	Registra un gestore eventi di attività per i membri aggiunti evento, generato per qualsiasi attività di aggiornamento della conversazione in ingresso che include membri aggiunti alla conversazione.
onMembersRemoved(BotHandler)	Registra un gestore eventi di attività per i membri rimossi evento, generato per qualsiasi attività di aggiornamento della conversazione in ingresso che include i membri rimossi dalla conversazione.
onMessage(BotHandler)	Registra un gestore eventi di attività per l'evento messaggio, generato per ogni attività del messaggio in arrivo.
onMessageReaction(BotHandler)	Registra un gestore eventi di attività per la reazione messaggio evento, generato per ogni attività di reazione al messaggio in arrivo.
onReactionsAdded(BotHandler)	Registra un gestore eventi di attività per le reazioni aggiunte evento, generato per qualsiasi attività di reazione al messaggio in arrivo che descrive le reazioni aggiunte a un messaggio.
onReactionsRemoved(BotHandler)	Registra un gestore eventi di attività per le reazioni rimosse evento, generato per qualsiasi attività di reazione al messaggio in arrivo che descrive le reazioni rimosse da un messaggio.
onTokenResponseEvent(BotHandler)	Registra un gestore eventi di attività per l'evento token di risposta token, generato per qualsiasi attività di evento tokens/response in ingresso. Questi vengono generati come parte del flusso di autenticazione OAuth.
onTurn(BotHandler)	Registra un gestore eventi attività per l'evento di turno, generato per ogni attività in ingresso, indipendentemente dal tipo.
onTyping(BotHandler)	Registra un gestore eventi attività per l'attività digitando attività.
onUnrecognizedActivityType(BotHandler)	Registra un gestore eventi di attività per il tipo di attività non riconosciuto evento, generato per un'attività in ingresso con un tipo per cui il ActivityHandler non fornisce un gestore eventi.
run(TurnContext)	Chiamato per avviare il processo di emissione dell'evento.

Dettagli metodo

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

Registra un gestore per gli eventi TeamsChannelCreated, ad esempio quando viene creato un canale.

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

Parametri

handler

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

Callback per gestire l'evento creato dal canale teams.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsChannelDeleted, ad esempio quando viene eliminato un canale.

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

Parametri

handler

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

Callback per gestire l'evento eliminato del canale di Teams.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsChannelRenamed, ad esempio quando viene rinominato un canale.

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

Parametri

handler

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

Callback per gestire l'evento rinominato del canale teams.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsChannelRestored, ad esempio quando viene ripristinato un canale.

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

Parametri

handler

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

Callback per gestire l'evento ripristinato del canale teams.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per quando termina una riunione di Teams.

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

Parametri

handler

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

Callback che gestisce gli eventi di fine riunione.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per all'avvio di una riunione di Teams.

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

Parametri

handler

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

Callback che gestisce gli eventi di avvio riunione.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsMembersAdded, ad esempio quando i membri diversi dal bot si uniscono al canale, ad esempio la logica di benvenuto del bot.

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

Parametri

handler

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

Callback per gestire l'evento aggiunto ai membri del team.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsMembersRemoved, ad esempio quando i membri diversi dal bot lasciano il canale, ad esempio la logica good-bye del bot.

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

Parametri

handler

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

Callback per gestire l'evento rimosso dai membri dei team.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per quando viene inviata una ricevuta di lettura.

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

Parametri

handler

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

Callback che gestisce gli eventi Read Receipt.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsTeamArchived, ad esempio quando un team viene archiviato.

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

Parametri

handler

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

Callback per gestire l'evento archiviato dal team di teams.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsTeamDeleted, ad esempio quando un team viene eliminato.

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

Parametri

handler

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

Callback per gestire l'evento eliminato dal team di teams.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsTeamHardDeleted, ad esempio quando un team viene eliminato definitivamente.

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

Parametri

handler

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

Callback per gestire l'evento eliminato definitivamente dal team.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsTeamRenamed, ad esempio quando un team viene rinominato.

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

Parametri

handler

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

Callback per gestire l'evento rinominato del team di team.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsTeamRestored, ad esempio quando un team viene ripristinato.

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

Parametri

handler

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

Callback per gestire l'evento ripristinato dal team di team.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

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

Registra un gestore per gli eventi TeamsTeamUnarchived, ad esempio quando un team non è archiviato.

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

Parametri

handler

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

Callback per gestire l'evento non archiviato del team di team.

Restituisce

this

Promessa che rappresenta il lavoro in coda.

Dettagli dei metodi ereditati

onCommand(BotHandler)

Registra un gestore eventi attività per l'attività comando.

function onCommand(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Per gestire un evento Command, usare il onCommand gestore eventi specifico del tipo.

ereditato da ActivityHandler.onCommand

onCommandResult(BotHandler)

Registra un gestore eventi attività per l'attività CommandResult.

function onCommandResult(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Per gestire un evento CommandResult, usare il onCommandResult gestore eventi specifico del tipo.

ereditato da ActivityHandler.onCommandResult

onConversationUpdate(BotHandler)

Registra un gestore eventi attività per l'evento di aggiornamento della conversazione , generato per ogni attività di aggiornamento della conversazione in ingresso.

function onConversationUpdate(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Le attività di aggiornamento della conversazione descrivono le modifiche apportate ai metadati di una conversazione, ad esempio titolo, partecipanti o altre informazioni specifiche del canale.

Per gestire quando i membri vengono aggiunti o rimossi dalla conversazione, usare il onMembersAdded e onMembersRemoved gestori eventi di sottotipo.

Ereditato da ActivityHandler.onConversationUpdate

onDialog(BotHandler)

Registra un gestore eventi di attività per la finestra di dialogo evento, generato come ultimo evento per un'attività in ingresso.

function onDialog(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Ereditato da ActivityHandler.onDialog

onEndOfConversation(BotHandler)

Registra un gestore eventi di attività per la fine della conversazione 'attività di.

function onEndOfConversation(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Questa attività viene in genere inviata da una competenza a un chiamante competenza che indica la fine di tale conversazione figlio specifica.

Per gestire una conversazione finale, usare il onEndOfConversation gestore eventi specifico del tipo.

ereditato da ActivityHandler.onEndOfConversation

onEvent(BotHandler)

Registra un gestore eventi di attività per l'evento evento, generato per ogni attività dell'evento in ingresso.

function onEvent(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Le attività evento comunicano informazioni a livello di codice da un client o da un canale a un bot. Il significato di un'attività di evento è definito dal nome proprietà dell'attività, che è significativo nell'ambito di un canale. Le attività di evento sono progettate per includere informazioni interattive (ad esempio clic sul pulsante) e informazioni non interattive (ad esempio una notifica di un client che aggiorna automaticamente un modello di riconoscimento vocale incorporato).

Per gestire un evento di tokens/response, usare il onTokenResponseEvent gestore eventi di sottotipo. Per gestire altri eventi denominati, aggiungere logica a questo gestore.

ereditato da ActivityHandler.onEvent

onInstallationUpdate(BotHandler)

Registra un gestore eventi attività per l'attività installationupdate.

function onInstallationUpdate(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Per gestire un evento InstallationUpdate, usare il onInstallationUpdate gestore eventi specifico del tipo.

ereditato da ActivityHandler.onInstallationUpdate

onInstallationUpdateAdd(BotHandler)

Registra un gestore eventi di attività per l''attività add.

function onInstallationUpdateAdd(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler. Per gestire un evento InstallationUpdateAdd, usare il onInstallationUpdateAdd gestore eventi specifico del tipo.

Ereditato da ActivityHandler.onInstallationUpdateAdd

onInstallationUpdateRemove(BotHandler)

Registra un gestore eventi di attività per l''operazione di rimozione'attività.

function onInstallationUpdateRemove(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Per gestire un evento InstallationUpdateRemove, usare il onInstallationUpdateRemove gestore eventi specifico del tipo.

ereditato da ActivityHandler.onInstallationUpdateRemove

onMembersAdded(BotHandler)

Registra un gestore eventi di attività per i membri aggiunti evento, generato per qualsiasi attività di aggiornamento della conversazione in ingresso che include membri aggiunti alla conversazione.

function onMembersAdded(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

La proprietà dell'attivitàAggiungi contiene i membri aggiunti alla conversazione, che possono includere il bot.

Per gestire gli eventi di aggiornamento della conversazione in generale, usare il onConversationUpdate gestore eventi specifico del tipo.

ereditato da ActivityHandler.onMembersAdded

onMembersRemoved(BotHandler)

Registra un gestore eventi di attività per i membri rimossi evento, generato per qualsiasi attività di aggiornamento della conversazione in ingresso che include i membri rimossi dalla conversazione.

function onMembersRemoved(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

La proprietà membri dell'attivitàRemoved contiene i membri rimossi dalla conversazione, che possono includere il bot.

Per gestire gli eventi di aggiornamento della conversazione in generale, usare il onConversationUpdate gestore eventi specifico del tipo.

ereditato da ActivityHandler.onMembersRemoved

onMessage(BotHandler)

Registra un gestore eventi di attività per l'evento messaggio, generato per ogni attività del messaggio in arrivo.

function onMessage(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Le attività di messaggio rappresentano il contenuto che deve essere visualizzato all'interno di un'interfaccia di conversazione e può contenere testo, riconoscimento vocale, schede interattive e allegati binari o sconosciuti. Non tutte le attività del messaggio contengono testo, la proprietà testo dell'attività può essere null o undefined.

ereditato da ActivityHandler.onMessage

onMessageReaction(BotHandler)

Registra un gestore eventi di attività per la reazione messaggio evento, generato per ogni attività di reazione al messaggio in arrivo.

function onMessageReaction(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Le attività di reazione ai messaggi rappresentano un'interazione sociale su un'attività di messaggio esistente all'interno di una conversazione. L'attività originale viene indicata dalla proprietà replyTo Id dell'attività di reazione del messaggio. Il dalla proprietà rappresenta l'origine della reazione, ad esempio l'utente che ha reagito al messaggio.

Per gestire quando le reazioni vengono aggiunte o rimosse dai messaggi nella conversazione, usare il onReactionsAdded e onReactionsRemoved gestori eventi di sottotipo.

ereditato da ActivityHandler.onMessageReaction

onReactionsAdded(BotHandler)

Registra un gestore eventi di attività per le reazioni aggiunte evento, generato per qualsiasi attività di reazione al messaggio in arrivo che descrive le reazioni aggiunte a un messaggio.

function onReactionsAdded(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Le reazioni dell'attivitàAggiungi proprietà includono una o più reazioni aggiunte.

Per gestire gli eventi di reazione ai messaggi in generale, usare il onMessageReaction gestore eventi specifico del tipo.

Ereditato da ActivityHandler.onReactionsAdded

onReactionsRemoved(BotHandler)

Registra un gestore eventi di attività per le reazioni rimosse evento, generato per qualsiasi attività di reazione al messaggio in arrivo che descrive le reazioni rimosse da un messaggio.

function onReactionsRemoved(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Le reazioni dell'attivitàRemoved proprietà includono una o più reazioni rimosse.

Per gestire gli eventi di reazione ai messaggi in generale, usare il onMessageReaction gestore eventi specifico del tipo.

ereditato da ActivityHandler.onReactionsRemoved

onTokenResponseEvent(BotHandler)

Registra un gestore eventi di attività per l'evento token di risposta token, generato per qualsiasi attività di evento tokens/response in ingresso. Questi vengono generati come parte del flusso di autenticazione OAuth.

function onTokenResponseEvent(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Il valore dell'attività proprietà contiene il token utente.

Se il bot gestisce l'autenticazione usando un OAuthPrompt all'interno di una finestra di dialogo, la finestra di dialogo dovrà ricevere questa attività per completare il flusso di autenticazione.

Per gestire in generale altri eventi denominati ed eventi evento, usare il onEvent gestore eventi specifico del tipo.

Ereditato da ActivityHandler.onTokenResponseEvent

onTurn(BotHandler)

Registra un gestore eventi attività per l'evento di turno, generato per ogni attività in ingresso, indipendentemente dal tipo.

function onTurn(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

ereditato da ActivityHandler.onTurn

onTyping(BotHandler)

Registra un gestore eventi attività per l'attività digitando attività.

function onTyping(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Per gestire un evento Typing, utilizzare il onTyping gestore eventi specifico del tipo.

ereditato da ActivityHandler.onTyping

onUnrecognizedActivityType(BotHandler)

Registra un gestore eventi di attività per il tipo di attività non riconosciuto evento, generato per un'attività in ingresso con un tipo per cui il ActivityHandler non fornisce un gestore eventi.

function onUnrecognizedActivityType(handler: BotHandler): this

Parametri

handler

BotHandler

Gestore eventi.

Restituisce

this

Riferimento all'oggetto ActivityHandler.

Commenti

Il ActivityHandler non definisce eventi per tutti i tipi di attività definiti nello schema dell'attività di Bot Framework . Inoltre, i canali e gli adattatori personalizzati possono creare Attività con tipi non inclusi nello schema. Quando il gestore attività riceve un evento di questo tipo, genera un evento di tipo di attività non riconosciuto.

Il tipo di dell'attività proprietà contiene il tipo di attività.

Ereditato da ActivityHandler.onUnrecognizedActivityType

run(TurnContext)

Chiamato per avviare il processo di emissione dell'evento.

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

Parametri

context

TurnContext

Oggetto di contesto per il turno corrente.

Restituisce

Promise<void>

Commenti

In genere, questo metodo viene fornito come gestore di funzioni che l'adapter chiama per eseguire la logica del bot dopo che l'attività ricevuta è stata pre-elaborata dall'adapter e indirizzata attraverso qualsiasi middleware.

Per esempio:

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

Vedere anche

• BotFrameworkAdapter.processActivity

ereditato da ActivityHandler.run