ActivityHandler Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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ı |
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) temel davranışı kullanıldığında |
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ı |
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 |
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) temel davranışı kullanıldığında bir |
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. |