ActivityHandler Classe

Definizione

Implementazione dell'interfaccia IBot, destinata a un'ulteriore sottoclasse.

public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
    interface IBot
Public Class ActivityHandler
Implements IBot
Ereditarietà
ActivityHandler
Derivato
Implementazioni

Commenti

Derivare da questa classe al codice plug-in per gestire tipi di attività specifici. È possibile aggiungere pre-elaborazione e post-elaborazione degli oggetti Activity chiamando l'implementazione della classe base dalla classe derivata.

Costruttori

ActivityHandler()

Implementazione dell'interfaccia IBot, destinata a un'ulteriore sottoclasse.

Metodi

CreateInvokeResponse(Object)

Factory InvokeResponse che inizializza il corpo del parametro passato e lo stato è uguale a OK.

OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)

Richiamato quando il bot invia un'azione scheda adattiva.

OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)

Richiamato quando viene ricevuta un'attività di comando quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). I comandi sono richieste per eseguire un'azione e i ricevitori rispondono in genere con una o più attività commandResult. I ricevitori devono anche rifiutare in modo esplicito le attività di comando non supportate.

OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken)

Richiamato quando viene ricevuta un'attività CommandResult quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Le attività CommandResult possono essere usate per comunicare il risultato di un'esecuzione del comando.

OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)

Richiamato quando viene ricevuta un'attività di aggiornamento della conversazione dal canale quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Le attività di aggiornamento della conversazione sono utili quando si tratta di rispondere agli utenti aggiunti o rimossi dalla conversazione. Ad esempio, un bot potrebbe rispondere a un utente aggiunto salutando l'utente. Per impostazione predefinita, questo metodo chiamerà OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se gli utenti sono stati aggiunti o OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) se sono stati rimossi utenti. Il metodo controlla l'ID membro in modo che risponda solo agli aggiornamenti relativi ai membri diversi dal bot stesso.

OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per EndOfConversation attività, ad esempio la logica di conversazione.

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)

Richiamato quando viene ricevuta un'attività evento dal connettore quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Le attività degli eventi possono essere usate per comunicare molte cose diverse. Per impostazione predefinita, questo metodo chiamerà OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) se il nome dell'attività è tokens/response o OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) in caso contrario. Un evento tokens/response può essere attivato da un OAuthCard.

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Richiamato quando viene ricevuto un evento diverso da tokens/response quando viene utilizzato il comportamento di base di OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken). Questo metodo può facoltativamente essere sottoposto a override se il bot deve gestire eventi vari. Per impostazione predefinita, questo metodo non esegue alcuna operazione.

OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per InstallationUpdate attività.

OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per InstallationUpdate attività con 'action' impostata su 'add'.

OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per InstallationUpdate attività con 'action' impostata su 'remove'.

OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)

Richiamato quando viene ricevuta un'attività invoke dal connettore quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Le attività invoke possono essere usate per comunicare molte cose diverse. Per impostazione predefinita, questo metodo chiamerà OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) se il nome dell'attività è signin/verifyState o signin/tokenExchange. Un signin/verifyState o signin/tokenExchange invoke può essere attivato da un OAuthCard.

OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica per quando i membri diversi dal bot partecipano alla conversazione, ad esempio la logica di benvenuto del bot.

OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica per quando i membri diversi dal bot lasciano la conversazione, ad esempio la logica good-bye del bot.

OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per Message attività, ad esempio la logica di conversazione.

OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per MessageDelete attività, ad esempio la logica di conversazione.

OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)

Richiamato quando viene ricevuta un'attività evento dal connettore quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Le reazioni ai messaggi corrispondono all'utente aggiungendo un 'like' o 'sad' ecc. (spesso un'emoji) a un'attività inviata in precedenza. Le reazioni ai messaggi sono supportate solo da alcuni canali. L'attività a cui corrisponde la reazione del messaggio è indicata nella proprietà replyToId. Il valore di questa proprietà è l'ID attività di un'attività inviata in precedenza restituita al bot come risposta da una chiamata di invio.

OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per MessageUpdate attività, ad esempio la logica di conversazione.

OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)

Eseguire l'override di questo oggetto in una classe derivata per fornire la logica per quando le reazioni a un'attività precedente vengono aggiunte alla conversazione.

OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)

Eseguire l'override di questo oggetto in una classe derivata per fornire la logica per quando le reazioni a un'attività precedente vengono rimosse dalla conversazione.

OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)

Richiamato quando il bot viene inviato a un'attività 'invoke' con nome 'application/search'.

OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)

Richiamato quando viene ricevuto un evento signin/verifyState o signin/tokenExchange quando viene usato il comportamento di base di OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken). Se si usa un OAuthPrompt, eseguire l'override di questo metodo per inoltrare questo Activity alla finestra di dialogo corrente. Per impostazione predefinita, questo metodo non esegue alcuna operazione.

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Richiamato quando viene ricevuto un evento tokens/response quando viene usato il comportamento di base di OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken). Se si usa un OAuthPrompt, eseguire l'override di questo metodo per inoltrare questo Activity alla finestra di dialogo corrente. Per impostazione predefinita, questo metodo non esegue alcuna operazione.

OnTurnAsync(ITurnContext, CancellationToken)

Chiamato dall'adapter (ad esempio, un BotFrameworkAdapter) in fase di esecuzione per elaborare un Activityin ingresso.

OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)

Eseguire l'override in una classe derivata per fornire logica specifica per Typing attività, ad esempio la logica di conversazione.

OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

Richiamato quando viene usata un'attività diversa da un messaggio, un aggiornamento della conversazione o un evento quando viene usato il comportamento di base di OnTurnAsync(ITurnContext, CancellationToken). Se sottoposto a override, potrebbe rispondere a qualsiasi altro tipo di attività, ad esempio ContactRelationUpdate o EndOfConversation. Per impostazione predefinita, questo metodo non esegue alcuna operazione.

Si applica a