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.
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) |
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
temel davranışı kullanıldığında dışında |
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 |
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 |
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) |
temel davranışı kullanıldığında bir |
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. |