ActivityHandler Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Implementace IBot rozhraní, určená pro další podtřídy.
public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
interface IBot
Public Class ActivityHandler
Implements IBot
- Dědičnost
-
ActivityHandler
- Odvozené
- Implementuje
Poznámky
Odvození z této třídy pro připojení kódu pro zpracování konkrétních typů aktivit. Před a po zpracování Activity objektů lze přidat voláním implementace základní třídy z odvozené třídy.
Konstruktory
ActivityHandler() |
Implementace IBot rozhraní, určená pro další podtřídy. |
Metody
CreateInvokeResponse(Object) |
Továrna InvokeResponse , která inicializuje tělo na předaný parametr a stav se rovná OK. |
OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken) |
Vyvolá se při odeslání akce adaptivní karty robota. |
OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) |
Vyvoláno při přijetí aktivity příkazu při použití základního OnTurnAsync(ITurnContext, CancellationToken) chování. Příkazy jsou požadavky na provedení akce a příjemci obvykle reagují jednou nebo více aktivitami commandResult. Očekává se také, že příjemci explicitně odmítnou nepodporované aktivity příkazů. |
OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken) |
Vyvoláno při přijetí aktivity CommandResult při použití základního OnTurnAsync(ITurnContext, CancellationToken) chování. Aktivity CommandResult lze použít ke sdělení výsledku spuštění příkazu. |
OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Vyvolá se při přijetí aktivity aktualizace konverzace z kanálu při použití základního OnTurnAsync(ITurnContext, CancellationToken) chování. Aktivity aktualizace konverzací jsou užitečné, pokud jde o reakce na uživatele, kteří jsou přidáni do konverzace nebo z ní odebraní. Robot může například odpovědět na přidaného uživatele pozdravem uživatele. Ve výchozím nastavení bude tato metoda volat OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) , pokud byli přidáni uživatelé nebo OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) byli odebráni. Metoda zkontroluje ID člena, aby reagovalo pouze na aktualizace týkající se jiných členů než samotného robota. |
OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken) |
Přepsání v odvozené třídě poskytuje logiku specifickou pro EndOfConversation aktivity, jako je například konverzační logika. |
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) |
Vyvolá se při přijetí aktivity události z konektoru při použití základního OnTurnAsync(ITurnContext, CancellationToken) chování.
Aktivity událostí se dají použít ke komunikaci mnoha různých věcí.
Ve výchozím nastavení bude tato metoda volat OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) , pokud je |
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Vyvoláno při přijetí jiné události než |
OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken) |
Přepište ji v odvozené třídě, aby poskytovala logiku specifickou pro InstallationUpdate aktivity. |
OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken) |
Přepište to v odvozené třídě, aby se poskytla logika specifická pro InstallationUpdate aktivity s "akcí" nastavenou na "add". |
OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken) |
Přepište tuto hodnotu v odvozené třídě, aby poskytovala logiku specifickou pro InstallationUpdate aktivity s "akcí" nastavenou na "remove". |
OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) |
Vyvolá se při přijetí aktivity vyvolání z konektoru při použití základního OnTurnAsync(ITurnContext, CancellationToken) chování.
Aktivity volání se dají použít ke komunikaci mnoha různých věcí.
Ve výchozím nastavení bude tato metoda volat OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) , pokud je |
OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Přepište ho v odvozené třídě, abyste získali logiku pro to, kdy se ke konverzaci připojují jiní členové než robot, například uvítací logika robota. |
OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Přepište to v odvozené třídě, abyste získali logiku pro to, kdy členové, kteří opouštějí konverzaci, například logiku sbohem robota. |
OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken) |
Přepsání v odvozené třídě poskytuje logiku specifickou pro Message aktivity, jako je například konverzační logika. |
OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken) |
Vyvolá se při přijetí aktivity události z konektoru při použití základního OnTurnAsync(ITurnContext, CancellationToken) chování. Reakce na zprávy odpovídají tomu, že uživatel přidá k dříve odeslané aktivitě "lajk" nebo "smutný" atd. (často emoji). Reakce na zprávy jsou podporovány pouze několika kanály. Aktivita, které odpovídá reakce na zprávu, je uvedena ve vlastnosti replyToId. Hodnota této vlastnosti je ID aktivity dříve odeslané aktivity, která se robotovi vrátila jako odpověď na odeslanou hovor. |
OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken) |
Přepište tuto možnost v odvozené třídě, abyste získali logiku pro přidání reakcí na předchozí aktivitu do konverzace. |
OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken) |
Přepište to v odvozené třídě, abyste získali logiku pro to, kdy se z konverzace odeberou reakce na předchozí aktivitu. |
OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken) |
Vyvolá se při odeslání aktivity invoke robota s názvem application/search. |
OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) |
Vyvolá se při |
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Vyvoláno při |
OnTurnAsync(ITurnContext, CancellationToken) |
Volá se adaptérem (například a BotFrameworkAdapter) za běhu, aby bylo možné zpracovat příchozí Activityobjekt . |
OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken) |
Přepsání v odvozené třídě poskytuje logiku specifickou pro Typing aktivity, jako je například konverzační logika. |
OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken) |
Vyvolá se při přijetí jiné aktivity než zprávy, aktualizace konverzace nebo události při použití základního OnTurnAsync(ITurnContext, CancellationToken) chování. Pokud je přepsáno, mohlo by to potenciálně reagovat na některý z dalších typů aktivit, jako je ContactRelationUpdate nebo EndOfConversation. Ve výchozím nastavení tato metoda nedělá nic. |