Aracılığıyla paylaş


ActivityHandler Sınıf

Tanım

Arabirimin IBot daha fazla alt sınıflama için tasarlanmış bir uygulaması.

public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
    interface IBot
Public Class ActivityHandler
Implements IBot
Devralma
ActivityHandler
Türetilmiş
Uygulamalar

Açıklamalar

Belirli etkinlik türlerini işlemek üzere kod eklemek için bu sınıftan türetilir. Nesnelerin ön ve son işlemesi Activity , türetilmiş sınıftan temel sınıf uygulaması çağrılarak eklenebilir.

Oluşturucular

ActivityHandler()

Arabirimin IBot daha fazla alt sınıflama için tasarlanmış bir uygulaması.

Yöntemler

CreateInvokeResponse(Object)

InvokeResponse Gövdeyi geçirilen parametreye ve Tamam'a eşit duruma başlatan bir fabrika.

OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)

Bota Uyarlamalı Kart Eylemi Gönderildiğinde Çağrılır.

OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)

temel davranışı kullanıldığında bir komut etkinliği alındığında çağrılır OnTurnAsync(ITurnContext, CancellationToken) . Komutlar bir eylem gerçekleştirme istekleridir ve alıcılar genellikle bir veya daha fazla commandResult etkinliğiyle yanıt verir. Alıcıların desteklenmeyen komut etkinliklerini açıkça reddetmesi de beklenir.

OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken)

temel davranışı kullanıldığında CommandResult etkinliği alındığında çağrılır OnTurnAsync(ITurnContext, CancellationToken) . CommandResult etkinlikleri, komut yürütmenin sonucunu iletmek için kullanılabilir.

OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)

temel davranışı kullanıldığında kanaldan bir konuşma güncelleştirme etkinliği alındığında çağrılır OnTurnAsync(ITurnContext, CancellationToken) . Konuşma güncelleştirme etkinlikleri, konuşmaya eklenen veya konuşmadan kaldırılan kullanıcılara yanıt verme konusunda yararlıdır. Örneğin, bir bot kullanıcıyı selamlayarak eklenen kullanıcıya yanıt verebilir. Varsayılan olarak, herhangi bir kullanıcı eklendiyse veya OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) herhangi bir kullanıcı kaldırılmışsa bu yöntem çağrılırOnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). yöntemi üye kimliğini denetler, böylece yalnızca bot dışındaki üyelerle ilgili güncelleştirmelere yanıt verir.

OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken)

Konuşma mantığı gibi etkinliklere özgü mantık sağlamak için EndOfConversation türetilmiş bir sınıfta bunu geçersiz kılın.

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)

temel davranışı kullanıldığında bağlayıcıdan bir olay etkinliği alındığında çağrılır OnTurnAsync(ITurnContext, CancellationToken) . Olay etkinlikleri birçok farklı şeyi iletmek için kullanılabilir. Varsayılan olarak, etkinliğin adı veya OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) başka bir adı varsa bu yöntem çağrılır.OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)tokens/response Bir tokens/response olay tarafından OAuthCardtetiklenebilir.

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

temel davranışı kullanıldığında dışında tokens/response bir olay alındığında çağrılır OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) . Bot çeşitli olayları işlemek üzere tasarlanıyorsa bu yöntem isteğe bağlı olarak geçersiz kılınabilir. Varsayılan olarak, bu yöntem hiçbir şey yapmaz.

OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Etkinliklere özgü InstallationUpdate mantık sağlamak için türetilmiş bir sınıfta bunu geçersiz kılın.

OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

'eylem' 'ekle' olarak ayarlanmış etkinliklere özgü mantık sağlamak için InstallationUpdate türetilmiş bir sınıfta bunu geçersiz kılın.

OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

'eylem' öğesinin 'remove' olarak ayarlandığı etkinliklere özgü mantık sağlamak için InstallationUpdate türetilmiş bir sınıfta bunu geçersiz kılın.

OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)

temel davranışı kullanıldığında bağlayıcıdan bir çağırma etkinliği alındığında çağrılır OnTurnAsync(ITurnContext, CancellationToken) . Çağırma etkinlikleri birçok farklı şeyi iletmek için kullanılabilir. Varsayılan olarak, etkinliğin adı veya signin/tokenExchangeise bu yöntem çağrısı OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) yapacaktırsignin/verifyState. veya signin/verifyStatesignin/tokenExchange çağrısı bir OAuthCardtarafından tetiklenebilir.

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

Botunuzun karşılama mantığı gibi bot dışındaki üyeler konuşmaya katıldığında mantık sağlamak için türetilmiş bir sınıfta bunu geçersiz kılın.

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

Botunuzun veda mantığı gibi bot dışındaki üyeler konuşmadan ayrıldığında mantık sağlamak için bunu türetilmiş bir sınıfta geçersiz kılın.

OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken)

Konuşma mantığı gibi etkinliklere özgü mantık sağlamak için Message türetilmiş bir sınıfta bunu geçersiz kılın.

OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)

temel davranışı kullanıldığında bağlayıcıdan bir olay etkinliği alındığında çağrılır OnTurnAsync(ITurnContext, CancellationToken) . İleti tepkileri, daha önce gönderilen bir etkinliğe 'like' veya 'sad' vb. (genellikle emoji) ekleyen kullanıcıya karşılık gelir. İleti tepkileri yalnızca birkaç kanal tarafından desteklenir. İleti tepkisinin karşılık gelen etkinliği replyToId özelliğinde gösterilir. Bu özelliğin değeri, gönderme çağrısından gelen yanıt olarak bota geri verilen daha önce gönderilen etkinliğin etkinlik kimliğidir.

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

Önceki bir etkinliğe yapılan tepkilerin konuşmaya ne zaman eklendiğine yönelik mantık sağlamak için bunu türetilmiş bir sınıfta geçersiz kılın.

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

Önceki bir etkinliğe yönelik tepkiler konuşmadan kaldırıldığında mantık sağlamak için türetilmiş bir sınıfta bunu geçersiz kılın.

OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)

Bota 'uygulama/arama' adına sahip bir 'invoke' etkinliği gönderildiğinde çağrılır.

OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)

temel davranışı kullanıldığında veya signin/verifyStatesignin/tokenExchange olayı alındığında çağrılır OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) . kullanıyorsanız OAuthPrompt, bunu geçerli iletişim kutusuna iletmek için bu Activity yöntemi geçersiz kılın. Varsayılan olarak, bu yöntem hiçbir şey yapmaz.

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

temel davranışı kullanıldığında bir tokens/response olay alındığında çağrılır OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) . kullanıyorsanız OAuthPrompt, bunu geçerli iletişim kutusuna iletmek için bu Activity yöntemi geçersiz kılın. Varsayılan olarak, bu yöntem hiçbir şey yapmaz.

OnTurnAsync(ITurnContext, CancellationToken)

Gelen Activityöğesini işlemek için çalışma zamanında bağdaştırıcı (örneğin, bir BotFrameworkAdapter) tarafından çağrılır.

OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)

Konuşma mantığı gibi etkinliklere özgü mantık sağlamak için Typing türetilmiş bir sınıfta bunu geçersiz kılın.

OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

temel davranışı kullanıldığında ileti, konuşma güncelleştirmesi veya olay dışında bir etkinlik alındığında çağrılır OnTurnAsync(ITurnContext, CancellationToken) . Geçersiz kılınırsa, bu işlem veya EndOfConversationgibi ContactRelationUpdate diğer etkinlik türlerinden herhangi birine yanıt verebilir. Varsayılan olarak, bu yöntem hiçbir şey yapmaz.

Şunlara uygulanır