ActivityHandler Kelas

Referensi

Definisi

Ruang nama:: Microsoft.Bot.Builder

Rakitan:: Microsoft.Bot.Builder.dll

Paket:: Microsoft.Bot.Builder v4.22.7

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Implementasi antarmuka IBot, ditujukan untuk subkelas lebih lanjut.

public class ActivityHandler : Microsoft.Bot.Builder.IBot

type ActivityHandler = class
    interface IBot

Public Class ActivityHandler
Implements IBot

Warisan: Object
ActivityHandler

Turunan: Microsoft.Bot.Builder.SharePoint.SharePointActivityHandler

Microsoft.Bot.Builder.Teams.TeamsActivityHandler

Penerapan: IBot

Keterangan

Berasal dari kelas ini untuk mencolokkan kode untuk menangani jenis aktivitas tertentu. Pra-dan pasca-pemrosesan objek Activity dapat ditambahkan dengan memanggil implementasi kelas dasar dari kelas turunan.

Konstruktor

ActivityHandler()

Implementasi antarmuka IBot, ditujukan untuk subkelas lebih lanjut.

Metode

CreateInvokeResponse(Object)	Pabrik InvokeResponse yang menginisialisasi isi ke parameter yang diteruskan dan statusnya sama dengan OK.
OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)	Dipanggil saat bot dikirimi Eksekusi Tindakan Kartu Adaptif.
OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)	Dipanggil saat aktivitas perintah diterima saat perilaku dasar OnTurnAsync(ITurnContext, CancellationToken) digunakan. Perintah adalah permintaan untuk melakukan tindakan dan penerima biasanya merespons dengan satu atau beberapa aktivitas commandResult. Penerima juga diharapkan untuk secara eksplisit menolak aktivitas perintah yang tidak didukung.
OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken)	Dipanggil saat aktivitas CommandResult diterima saat perilaku dasar OnTurnAsync(ITurnContext, CancellationToken) digunakan. Aktivitas CommandResult dapat digunakan untuk mengomunikasikan hasil eksekusi perintah.
OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)	Dipanggil saat aktivitas pembaruan percakapan diterima dari saluran saat perilaku dasar OnTurnAsync(ITurnContext, CancellationToken) digunakan. Aktivitas pembaruan percakapan berguna dalam menanggapi pengguna yang ditambahkan atau dihapus dari percakapan. Misalnya, bot dapat menanggapi pengguna yang ditambahkan dengan menyambut pengguna. Secara default, metode ini akan memanggil OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) jika ada pengguna yang telah ditambahkan atau OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) jika ada pengguna yang telah dihapus. Metode ini memeriksa ID anggota sehingga hanya merespons pembaruan mengenai anggota selain bot itu sendiri.
OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken)	Ambil alih ini dalam kelas turunan untuk menyediakan logika khusus untuk aktivitas EndOfConversation, seperti logika percakapan.
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)	Dipanggil saat aktivitas peristiwa diterima dari konektor saat perilaku dasar OnTurnAsync(ITurnContext, CancellationToken) digunakan. Aktivitas acara dapat digunakan untuk mengomunikasikan banyak hal yang berbeda. Secara default, metode ini akan memanggil OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) jika nama aktivitas `tokens/response` atau OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) sebaliknya. Peristiwa `tokens/response` dapat dipicu oleh OAuthCard.
OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)	Dipanggil saat peristiwa selain `tokens/response` diterima saat perilaku dasar OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) digunakan. Metode ini dapat secara opsional ditimpa jika bot dimaksudkan untuk menangani peristiwa lain-lain. Secara default, metode ini tidak melakukan apa pun.
OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)	Ambil alih ini dalam kelas turunan untuk menyediakan logika khusus untuk aktivitas InstallationUpdate.
OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)	Ambil alih ini di kelas turunan untuk menyediakan logika khusus untuk aktivitas InstallationUpdate dengan 'tindakan' yang diatur ke 'tambahkan'.
OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)	Ambil alih ini dalam kelas turunan untuk menyediakan logika khusus untuk aktivitas InstallationUpdate dengan 'tindakan' yang diatur ke 'hapus'.
OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)	Dipanggil ketika aktivitas pemanggilan diterima dari konektor ketika perilaku dasar OnTurnAsync(ITurnContext, CancellationToken) digunakan. Aktivitas pemanggilan dapat digunakan untuk mengomunikasikan banyak hal yang berbeda. Secara default, metode ini akan memanggil OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) jika nama aktivitas `signin/verifyState` atau `signin/tokenExchange`. Pemanggilan `signin/verifyState` atau `signin/tokenExchange` dapat dipicu oleh OAuthCard.
OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)	Ambil alih ini di kelas turunan untuk memberikan logika ketika anggota selain bot bergabung dengan percakapan, seperti logika selamat datang bot Anda.
OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)	Ambil alih ini di kelas turunan untuk memberikan logika ketika anggota selain bot meninggalkan percakapan, seperti logika selamat tinggal bot Anda.
OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken)	Ambil alih ini dalam kelas turunan untuk menyediakan logika khusus untuk aktivitas Message, seperti logika percakapan.
OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken)	Ambil alih ini dalam kelas turunan untuk menyediakan logika khusus untuk aktivitas MessageDelete, seperti logika percakapan.
OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)	Dipanggil saat aktivitas peristiwa diterima dari konektor saat perilaku dasar OnTurnAsync(ITurnContext, CancellationToken) digunakan. Reaksi pesan sesuai dengan pengguna yang menambahkan 'like' atau 'sad' dll. (sering emoji) ke aktivitas yang dikirim sebelumnya. Reaksi pesan hanya didukung oleh beberapa saluran. Aktivitas yang sesuai dengan reaksi pesan ditunjukkan dalam properti replyToId. Nilai properti ini adalah id aktivitas dari aktivitas yang dikirim sebelumnya yang diberikan kembali ke bot sebagai respons dari panggilan kirim.
OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)	Ambil alih ini dalam kelas turunan untuk menyediakan logika khusus untuk aktivitas MessageUpdate, seperti logika percakapan.
OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)	Ambil alih ini di kelas turunan untuk memberikan logika ketika reaksi terhadap aktivitas sebelumnya ditambahkan ke percakapan.
OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)	Ambil alih ini di kelas turunan untuk memberikan logika ketika reaksi terhadap aktivitas sebelumnya dihapus dari percakapan.
OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)	Dipanggil ketika bot dikirimi aktivitas 'panggil' yang memiliki nama 'aplikasi/pencarian'.
OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)	Dipanggil saat peristiwa `signin/verifyState` atau `signin/tokenExchange` diterima saat perilaku dasar OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) digunakan. Jika menggunakan `OAuthPrompt`, ambil alih metode ini untuk meneruskan Activity ini ke dialog saat ini. Secara default, metode ini tidak melakukan apa pun.
OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)	Dipanggil ketika peristiwa `tokens/response` diterima ketika perilaku dasar OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) digunakan. Jika menggunakan `OAuthPrompt`, ambil alih metode ini untuk meneruskan Activity ini ke dialog saat ini. Secara default, metode ini tidak melakukan apa pun.
OnTurnAsync(ITurnContext, CancellationToken)	Dipanggil oleh adaptor (misalnya, BotFrameworkAdapter) pada runtime untuk memproses Activitymasuk .
OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)	Ambil alih ini dalam kelas turunan untuk menyediakan logika khusus untuk aktivitas Typing, seperti logika percakapan.
OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)	Dipanggil saat aktivitas selain pesan, pembaruan percakapan, atau peristiwa diterima saat perilaku dasar OnTurnAsync(ITurnContext, CancellationToken) digunakan. Jika ditimpa, ini berpotensi merespons salah satu jenis aktivitas lain seperti ContactRelationUpdate atau EndOfConversation. Secara default, metode ini tidak melakukan apa pun.

Berlaku untuk