Aracılığıyla paylaş


ActivityHandler Sınıf

Tanım

Daha fazla alt sınıflama için tasarlanan IBot arabiriminin 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. türetilmiş sınıftan temel sınıf uygulaması çağrılarak Activity nesnelerinin ön ve son işlemesi eklenebilir.

Oluşturucular

ActivityHandler()

Daha fazla alt sınıflama için tasarlanan IBot arabiriminin bir uygulaması.

Yöntemler

CreateInvokeResponse(Object)

Geçirilen parametreye gövdeyi başlatan ve Tamam'a eşit bir InvokeResponse fabrikası.

OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)

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

OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)

OnTurnAsync(ITurnContext, CancellationToken) temel davranışı kullanıldığında bir komut etkinliği alındığında çağrılır. 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)

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

OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)

OnTurnAsync(ITurnContext, CancellationToken) temel davranışı kullanıldığında kanaldan bir konuşma güncelleştirme etkinliği alındığında çağrılır. 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 bir kullanıcıya yanıt verebilir. Varsayılan olarak, bu yöntem herhangi bir kullanıcı eklendiyse OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) çağırır veya herhangi bir kullanıcı kaldırılmışsa OnMembersRemovedAsync(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 EndOfConversation etkinliklere özgü mantık sağlamak için bunu türetilmiş bir sınıfta geçersiz kılın.

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)

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

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) temel davranışı kullanıldığında tokens/response dışında bir olay alındığında çağrılır. Botun çeşitli olayları işlemesi amaçlanı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)

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

OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

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

OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

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

OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)

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

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

Botunuzun hoş geldiniz mantığı gibi bot dışındaki üyelerin konuşmaya katılmasına yönelik mantık sağlamak için bunu türetilmiş bir sınıfta geçersiz kılın.

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

Bot dışındaki üyeler konuşmadan ayrıldığında (botunuzun veda mantığı gibi) 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 Message etkinliklere özgü mantık sağlamak için bunu türetilmiş bir sınıfta geçersiz kılın.

OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken)

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

OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)

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

OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)

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

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

Önceki bir etkinliğe yapılan tepkilerin konuşmaya ne zaman eklendiğinin mantığını 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 tepkilerin konuşmadan ne zaman kaldırıldığının mantığını sağlamak için bunu türetilmiş bir sınıfta geçersiz kılın.

OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)

Bota adı 'application/search' olan bir 'invoke' etkinliği gönderildiğinde çağrılır.

OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)

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

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

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

OnTurnAsync(ITurnContext, CancellationToken)

Gelen Activityiş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 Typing etkinliklere özgü mantık sağlamak için bunu türetilmiş bir sınıfta geçersiz kılın.

OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

OnTurnAsync(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. Geçersiz kılınırsa, bu, ContactRelationUpdate veya EndOfConversationgibi diğer etkinlik türlerinden herhangi birine yanıt verebilir. Varsayılan olarak, bu yöntem hiçbir şey yapmaz.

Şunlara uygulanır