Bagikan melalui


ActivityHandler Kelas

Definisi

Implementasi IBot antarmuka, ditujukan untuk subkelas lebih lanjut.

public class ActivityHandler : Microsoft.Bot.Builder.IBot
type ActivityHandler = class
    interface IBot
Public Class ActivityHandler
Implements IBot
Warisan
ActivityHandler
Turunan
Penerapan

Keterangan

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

Konstruktor

ActivityHandler()

Implementasi IBot antarmuka, 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 OnTurnAsync(ITurnContext, CancellationToken) dasar 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 OnTurnAsync(ITurnContext, CancellationToken) dasar digunakan. Aktivitas CommandResult dapat digunakan untuk mengomunikasikan hasil eksekusi perintah.

OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)

Dipanggil saat aktivitas pembaruan percakapan diterima dari saluran saat perilaku OnTurnAsync(ITurnContext, CancellationToken) dasar digunakan. Aktivitas pembaruan percakapan berguna dalam hal merespons pengguna yang ditambahkan atau dihapus dari percakapan. Misalnya, bot dapat menanggapi pengguna yang ditambahkan dengan menyapa 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 di kelas turunan untuk menyediakan logika khusus untuk EndOfConversation aktivitas, seperti logika percakapan.

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)

Dipanggil saat aktivitas peristiwa diterima dari konektor saat perilaku OnTurnAsync(ITurnContext, CancellationToken) dasar digunakan. Aktivitas acara dapat digunakan untuk mengomunikasikan banyak hal yang berbeda. Secara default, metode ini akan memanggil OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken) jika nama aktivitas adalah tokens/response atau OnEventAsync(ITurnContext<IEventActivity>, CancellationToken) sebaliknya. Peristiwa tokens/response dapat dipicu oleh OAuthCard.

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Dipanggil ketika peristiwa selain tokens/response diterima ketika perilaku OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) dasar digunakan. Metode ini secara opsional dapat ditimpa jika bot dimaksudkan untuk menangani peristiwa lain-lain. Secara default, metode ini tidak melakukan apa pun.

OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Ambil alih ini di kelas turunan untuk menyediakan logika khusus untuk InstallationUpdate aktivitas.

OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Ambil alih ini di kelas turunan untuk menyediakan logika khusus untuk InstallationUpdate aktivitas dengan 'tindakan' yang diatur ke 'add'.

OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

Ambil alih ini di kelas turunan untuk menyediakan logika khusus untuk InstallationUpdate aktivitas dengan 'tindakan' yang diatur ke 'remove'.

OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)

Dipanggil ketika aktivitas pemanggilan diterima dari konektor saat perilaku OnTurnAsync(ITurnContext, CancellationToken) dasar digunakan. Aktivitas pemanggilan dapat digunakan untuk mengomunikasikan banyak hal yang berbeda. Secara default, metode ini akan memanggil OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken) jika nama aktivitas adalah signin/verifyState atau signin/tokenExchange. signin/verifyState Atau signin/tokenExchange pemanggilan dapat dipicu oleh OAuthCard.

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

Ambil alih ini di kelas turunan untuk memberikan logika kapan anggota selain bot bergabung dalam 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 di kelas turunan untuk menyediakan logika khusus untuk Message aktivitas, seperti logika percakapan.

OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)

Dipanggil saat aktivitas peristiwa diterima dari konektor saat perilaku OnTurnAsync(ITurnContext, CancellationToken) dasar 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.

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 OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken) dasar digunakan. Jika menggunakan OAuthPrompt, ganti metode ini untuk meneruskan ini Activity ke dialog saat ini. Secara default, metode ini tidak melakukan apa pun.

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

Dipanggil saat tokens/response peristiwa diterima saat perilaku OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) dasar digunakan. Jika menggunakan OAuthPrompt, ganti metode ini untuk meneruskan ini Activity ke dialog saat ini. Secara default, metode ini tidak melakukan apa pun.

OnTurnAsync(ITurnContext, CancellationToken)

Dipanggil oleh adaptor (misalnya, a BotFrameworkAdapter) pada runtime untuk memproses masuk Activity.

OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)

Ambil alih ini di kelas turunan untuk menyediakan logika khusus untuk Typing aktivitas, seperti logika percakapan.

OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

Dipanggil saat aktivitas selain pesan, pembaruan percakapan, atau peristiwa diterima saat perilaku OnTurnAsync(ITurnContext, CancellationToken) dasar digunakan. Jika ditimpa, ini berpotensi menanggapi salah satu jenis aktivitas lain seperti ContactRelationUpdate atau EndOfConversation. Secara default, metode ini tidak melakukan apa pun.

Berlaku untuk