ActivityHandler Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Implementacja interfejsu IBot przeznaczona do dalszej podklasy.
public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
interface IBot
Public Class ActivityHandler
Implements IBot
- Dziedziczenie
-
ActivityHandler
- Pochodne
- Implementuje
Uwagi
Utwórz z tej klasy kod, aby podłączyć kod do obsługi określonych typów działań. Wstępnie i po przetworzeniu obiektów Activity można dodać przez wywołanie implementacji klasy bazowej z klasy pochodnej.
Konstruktory
ActivityHandler() |
Implementacja interfejsu IBot przeznaczona do dalszej podklasy. |
Metody
CreateInvokeResponse(Object) |
Fabryka InvokeResponse, która inicjuje treść do przekazanego parametru, a stan jest równy OK. |
OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken) |
Wywoływana, gdy bot jest wysyłany do wykonania akcji karty adaptacyjnej. |
OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken) |
Wywoływane, gdy działanie polecenia jest odbierane, gdy jest używane podstawowe zachowanie OnTurnAsync(ITurnContext, CancellationToken). Polecenia to żądania wykonania akcji, a odbiorniki zwykle odpowiadają za pomocą co najmniej jednego działania commandResult. Oczekuje się również, że odbiorniki jawnie odrzucają nieobsługiwane działania poleceń. |
OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken) |
Wywoływane po odebraniu działania CommandResult w przypadku użycia podstawowego zachowania OnTurnAsync(ITurnContext, CancellationToken). Działania CommandResult mogą służyć do komunikowania wyniku wykonania polecenia. |
OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Wywoływane, gdy działanie aktualizacji konwersacji jest odbierane z kanału, gdy jest używane podstawowe zachowanie OnTurnAsync(ITurnContext, CancellationToken). Działania aktualizacji konwersacji są przydatne, jeśli chodzi o reagowanie na użytkowników dodawanych do lub usuwanych z konwersacji. Na przykład bot może odpowiedzieć użytkownikowi dodawanemu przez powitanie użytkownika. Domyślnie ta metoda wywołuje OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken), jeśli zostali dodani lub OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken), jeśli zostali usunięci użytkownicy. Metoda sprawdza identyfikator elementu członkowskiego, aby odpowiadała tylko na aktualizacje dotyczące elementów członkowskich innych niż sam bot. |
OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla EndOfConversation działań, takich jak logika konwersacyjna. |
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) |
Wywoływane, gdy działanie zdarzenia jest odbierane z łącznika, gdy jest używane podstawowe zachowanie OnTurnAsync(ITurnContext, CancellationToken).
Działania zdarzeń mogą służyć do komunikowania się z wieloma różnymi rzeczami.
Domyślnie ta metoda wywołuje OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken), jeśli nazwa działania jest |
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Wywoływane, gdy jest odbierane zdarzenie inne niż |
OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla działań InstallationUpdate. |
OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla InstallationUpdate działań z wartością "action" ustawioną na "add". |
OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla InstallationUpdate działań z ustawieniem "action" na wartość "remove". |
OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) |
Wywoływane, gdy działanie wywołania jest odbierane z łącznika, gdy jest używane podstawowe zachowanie OnTurnAsync(ITurnContext, CancellationToken).
Wywoływanie działań może służyć do komunikowania się wielu różnych rzeczy.
Domyślnie ta metoda wywołuje OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken), jeśli nazwa działania jest |
OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę, gdy elementy członkowskie inne niż bot dołączają do konwersacji, takie jak logika powitalna bota. |
OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę, gdy członkowie inni niż bot opuszczają konwersację, na przykład logikę good-bye bota. |
OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla Message działań, takich jak logika konwersacyjna. |
OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla MessageDelete działań, takich jak logika konwersacyjna. |
OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken) |
Wywoływane, gdy działanie zdarzenia jest odbierane z łącznika, gdy jest używane podstawowe zachowanie OnTurnAsync(ITurnContext, CancellationToken). Reakcje komunikatów odpowiadają użytkownikowi dodającym wyraz "like" lub "sad" itp. (często emoji) do wcześniej wysłanego działania. Reakcje komunikatów są obsługiwane tylko przez kilka kanałów. Działanie, do którego odnosi się reakcja komunikatu, jest wskazywane we właściwości replyToId. Wartość tej właściwości jest identyfikatorem działania wcześniej wysłanego działania przekazanego z powrotem do bota jako odpowiedzi z wywołania wysyłania. |
OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla MessageUpdate działań, takich jak logika konwersacyjna. |
OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę, gdy reakcje na poprzednie działanie są dodawane do konwersacji. |
OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę, gdy reakcje na poprzednie działanie zostaną usunięte z konwersacji. |
OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken) |
Wywoływane, gdy bot jest wysyłany do działania "invoke" o nazwie "application/search". |
OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) |
Wywoływane, gdy jest odbierane zdarzenie |
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
Wywoływane po odebraniu zdarzenia |
OnTurnAsync(ITurnContext, CancellationToken) |
Wywoływana przez adapter (na przykład BotFrameworkAdapter) w czasie wykonywania w celu przetworzenia przychodzącego Activity. |
OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken) |
Zastąp to w klasie pochodnej, aby zapewnić logikę specyficzną dla Typing działań, takich jak logika konwersacyjna. |
OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken) |
Wywoływane, gdy jest odbierane działanie inne niż komunikat, aktualizacja konwersacji lub zdarzenie, gdy jest używane podstawowe zachowanie OnTurnAsync(ITurnContext, CancellationToken). W przypadku zastąpienia może to potencjalnie reagować na dowolne z innych typów działań, takich jak ContactRelationUpdate lub EndOfConversation. Domyślnie ta metoda nic nie robi. |