Etkinlik işleyicisi kullanan olay temelli konuşmalar

Bu işleyiciler için mantığınızı uygulamak için botunuzda aşağıdaki örnek etkinlik işleyicisi bölümünde olduğu gibi bu yöntemleri geçersiz kılacaksınız. Bu işleyicilerin her biri için temel uygulama yoktur, bu nedenle yalnızca geçersiz kılmanıza istediğiniz mantığı ekleyin.

Temel dönüş işleyicisini geçersiz kılmak isteyeceğiniz bazı durumlar vardır, örneğin dönüş sonunda kaydetme durumu . Bunu yaparken, temel uygulamasının ek kodunuzdan önce çalıştırıldığından emin olmak için ilk olarak öğesini çağırdığınızdan await base.OnTurnAsync(turnContext, cancellationToken); OnTurnAsync emin olun. Bu temel uygulama, diğer şeylerin yanı sıra gibi OnMessageActivityAsyncetkinlik işleyicilerinin geri kalanını çağırmaktan sorumludur.

JavaScript ActivityHandler bir olay yayımlayıcısı ve dinleyici düzeni kullanır. Örneğin, ileti etkinlikleri için bir olay dinleyicisi kaydetmek için yöntemini kullanın onMessage . Birden fazla dinleyici kaydedebilirsiniz. Bot bir ileti etkinliği aldığında, etkinlik işleyicisi gelen etkinliği görür ve etkinlik dinleyicilerinin her birini onMessage kaydedildikleri sırayla gönderir.

Botunuzu oluştururken iletileri işlemeye ve yanıtlamaya yönelik bot mantığınız dinleyicilere onMessage gider. Benzer şekilde, konuşmaya eklenen üyeleri işleme mantığınız dinleyicilerinize onMembersAdded gider. Bu mantık, konuşmaya her üye eklendiğinde çağrılır. Bu dinleyicileri eklemek için aşağıdaki Bot mantığı bölümünde gösterildiği gibi botunuza kaydedeceksiniz. Her dinleyici için bot mantığınızı ekleyin ve ardından sonunda arama next() yapmaya dikkat edin. çağrısı next()yaparak bir sonraki dinleyicinin çalıştırıldığından emin olursunuz.

Dönüş bitmeden önce durumu kaydettiğinizden emin olun. Bunu yapmak için etkinlik işleyicisi run yöntemini geçersiz kılabilir ve üst run öğesinin yöntemi tamamlandıktan sonra durumu kaydedebilirsiniz.

Temel dönüş işleyicisini geçersiz kılmak isteyeceğiniz yaygın bir durum yoktur, bu nedenle bunu yapmaya çalışırsanız dikkatli olun. adlı onDialogözel bir işleyici var. İşleyici onDialog , işleyicilerin geri kalanı çalıştırıldıktan ve belirli bir etkinlik türüne bağlı olmadığında sonunda çalışır. Yukarıdaki tüm işleyicilerde olduğu gibi, işlemin geri kalanının tamamlanmasını sağlamak için çağrısı next() yapmaya özen gösterin.

Bu işleyiciler için mantığınızı uygulamak için botunuzda aşağıdaki örnek etkinlik işleyicisi bölümünde olduğu gibi bu yöntemleri geçersiz kılacaksınız. Bu işleyicilerin her biri için temel uygulama yoktur, bu nedenle geçersiz kılmanıza istediğiniz mantığı ekleyin.

Temel dönüş işleyicisini geçersiz kılmak isteyeceğiniz bazı durumlar vardır, örneğin dönüş sonunda kaydetme durumu . Bunu yaparken, temel uygulamasının ek kodunuzdan önce çalıştırıldığından emin olmak için ilk olarak öğesini çağırdığınızdan super.onTurn(turnContext); onTurn emin olun. Bu temel uygulama, diğer şeylerin yanı sıra gibi onMessageActivityetkinlik işleyicilerinin geri kalanını çağırmaktan sorumludur.

Botunuzu oluştururken iletileri işlemeye ve yanıtlamaya yönelik bot mantığınız bu on_message_activity işleyiciye gider. Benzer şekilde, konuşmaya eklenen üyeleri işleme mantığınız, konuşmaya her üye eklendiğinde çağrılan işleyicinize on_members_added gider.

Örneğin, bot bir ileti etkinliği alırsa, dönüş işleyicisi gelen etkinliği görür ve etkinlik işleyicisine on_message_activity gönderir.

Bu işleyiciler için mantığınızı uygulamak için botunuzda aşağıdaki örnek etkinlik işleyicisi bölümünde olduğu gibi bu yöntemleri geçersiz kılacaksınız. Bu işleyicilerin her biri için temel uygulama yoktur, bu nedenle yalnızca geçersiz kılmanıza istediğiniz mantığı ekleyin.

Temel dönüş işleyicisini geçersiz kılmak isteyeceğiniz bazı durumlar vardır, örneğin dönüş sonunda kaydetme durumu . Bunu yaparken, temel uygulamasının ek kodunuzdan önce çalıştırıldığından emin olmak için ilk olarak öğesini çağırdığınızdan await super().on_turn(turnContext); on_turn emin olun. Bu temel uygulama, diğer şeylerin yanı sıra gibi on_message_activityetkinlik işleyicilerinin geri kalanını çağırmaktan sorumludur.

Ana bot mantığı bot kodunda tanımlanır. Bir botu etkinlik işleyicisi olarak uygulamak için, arabirimini uygulayan bot sınıfınızı öğesinden ActivityHandlertüretin IBot . ActivityHandler, ve OnMembersAddedAsyncgibi OnMessageActivityAsyncfarklı etkinlik türleri için çeşitli işleyicileri tanımlar. Bu yöntemler korunur, ancak 'den ActivityHandlertürediğimiz için geçersiz kılınabilir.

içinde ActivityHandler tanımlanan işleyiciler şunlardır:

Bu farklı işleyiciler, gelen HTTP isteğine karşılık gelen etkinlik hakkında bilgi sağlayan bir turnContext öğesine sahiptir. Etkinlikler çeşitli türlerde olabilir, bu nedenle her işleyici kendi dönüş bağlam parametresinde kesin olarak türlenmiş bir etkinlik sağlar; çoğu durumda, OnMessageActivityAsync her zaman işlenir ve genellikle en yaygın olanıdır.

Bu çerçevenin önceki 4.x sürümlerinde olduğu gibi genel yöntemini OnTurnAsyncuygulama seçeneği de vardır. Şu anda, bu yöntemin temel uygulaması hata denetimini işler ve sonra gelen etkinliğin türüne bağlı olarak belirli işleyicilerin her birini (bu örnekte tanımladığımız ikisi gibi) çağırır. Çoğu durumda, bu yöntemi yalnız bırakabilir ve tek tek işleyicileri kullanabilirsiniz, ancak durumunuz için özel bir uygulama OnTurnAsyncgerekiyorsa, yine de bir seçenektir.

Ana bot mantığı bot kodunda tanımlanır. Bir botu etkinlik işleyicisi olarak uygulamak için genişletin ActivityHandler. ActivityHandlerfarklı etkinlik türleri için çeşitli olayları tanımlar ve ve onConversationUpdategibi onMessage olay dinleyicilerini kaydederek botunuzun davranışını değiştirebilirsiniz.

Her olay türü için dinleyicileri kaydetmek için şu yöntemleri kullanın:

İşlemenin next devam etmesi için her işleyiciden continuation işlevini çağırın. Çağrılmazsa next etkinliğin işlenmesi sona erer.

Ana bot mantığı bot kodunda tanımlanır. Bir botu etkinlik işleyicisi olarak uygulamak için, arabirimini uygulayan bot sınıfınızı öğesinden ActivityHandlertüretin Bot . ActivityHandler, ve onMembersAddedgibi onMessageActivityfarklı etkinlik türleri için çeşitli işleyicileri tanımlar. Bu yöntemler korunur, ancak 'den ActivityHandlertürediğimiz için geçersiz kılınabilir.

içinde ActivityHandler tanımlanan işleyiciler şunlardır:

Bu farklı işleyiciler, gelen HTTP isteğine karşılık gelen etkinlik hakkında bilgi sağlayan bir turnContext öğesine sahiptir. Etkinlikler çeşitli türlerde olabilir, bu nedenle her işleyici kendi dönüş bağlam parametresinde kesin olarak türlenmiş bir etkinlik sağlar; çoğu durumda, onMessageActivity her zaman işlenir ve genellikle en yaygın olanıdır.

Genel yöntemini onTurnuygulama seçeneği de vardır. Şu anda, bu yöntemin temel uygulaması hata denetimini işler ve sonra gelen etkinliğin türüne bağlı olarak belirli işleyicilerin her birini (bu örnekte tanımladığımız ikisi gibi) çağırır. Çoğu durumda, bu yöntemi yalnız bırakabilir ve tek tek işleyicileri kullanabilirsiniz, ancak durumunuz için özel bir uygulama onTurngerekiyorsa, yine de bir seçenektir.

Ana bot mantığı bot kodunda tanımlanır. Bir botu etkinlik işleyicisi olarak uygulamak için, bot sınıfınızı öğesinden ActivityHandlertüreterek soyut Bot sınıftan türetilir. ActivityHandlerve on_members_addedgibi on_message_activity farklı etkinlik türleri için çeşitli işleyicileri tanımlar. Bu yöntemler korunur, ancak 'den ActivityHandlertürediğimiz için geçersiz kılınabilir.

içinde ActivityHandler tanımlanan işleyiciler şunlardır:

Bu farklı işleyiciler, gelen HTTP isteğine karşılık gelen etkinlik hakkında bilgi sağlayan bir turn_context öğesine sahiptir. Etkinlikler çeşitli türlerde olabilir, bu nedenle her işleyici kendi dönüş bağlam parametresinde kesin olarak türlenmiş bir etkinlik sağlar; çoğu durumda, on_message_activity her zaman işlenir ve genellikle en yaygın olanıdır.

Bu çerçevenin önceki 4.x sürümlerinde olduğu gibi genel yöntemini on_turnuygulama seçeneği de vardır. Şu anda, bu yöntemin temel uygulaması hata denetimini işler ve sonra gelen etkinliğin türüne bağlı olarak belirli işleyicilerin her birini (bu örnekte tanımladığımız ikisi gibi) çağırır. Çoğu durumda, bu yöntemi yalnız bırakabilir ve tek tek işleyicileri kullanabilirsiniz, ancak durumunuz için özel bir uygulama on_turngerekiyorsa, yine de bir seçenektir.

public class EchoBot : ActivityHandler
{
    protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
    {
        var replyText = $"Echo: {turnContext.Activity.Text}";
        await turnContext.SendActivityAsync(MessageFactory.Text(replyText, replyText), cancellationToken);
    }

    protected override async Task OnMembersAddedAsync(IList<ChannelAccount> membersAdded, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
    {
        var welcomeText = "Hello and welcome!";
        foreach (var member in membersAdded)
        {
            if (member.Id != turnContext.Activity.Recipient.Id)
            {
                await turnContext.SendActivityAsync(MessageFactory.Text(welcomeText, welcomeText), cancellationToken);
            }
        }
    }
}

class EchoBot extends ActivityHandler {
    constructor() {
        super();
        // See https://aka.ms/about-bot-activity-message to learn more about the message and other activity types.
        this.onMessage(async (context, next) => {
            const replyText = `Echo: ${ context.activity.text }`;
            await context.sendActivity(MessageFactory.text(replyText, replyText));
            // By calling next() you ensure that the next BotHandler is run.
            await next();
        });

        this.onMembersAdded(async (context, next) => {
            const membersAdded = context.activity.membersAdded;
            const welcomeText = 'Hello and welcome!';
            for (let cnt = 0; cnt < membersAdded.length; ++cnt) {
                if (membersAdded[cnt].id !== context.activity.recipient.id) {
                    await context.sendActivity(MessageFactory.text(welcomeText, welcomeText));
                }
            }
            // By calling next() you ensure that the next BotHandler is run.
            await next();
        });
    }
}

public class EchoBot extends ActivityHandler {

    @Override
    protected CompletableFuture<Void> onMessageActivity(TurnContext turnContext) {
        return turnContext.sendActivity(
            MessageFactory.text("Echo: " + turnContext.getActivity().getText())
        ).thenApply(sendResult -> null);
    }

    @Override
    protected CompletableFuture<Void> onMembersAdded(
        List<ChannelAccount> membersAdded,
        TurnContext turnContext
    ) {
        String welcomeText = "Hello and welcome!";
        return membersAdded.stream()
            .filter(
                member -> !StringUtils
                    .equals(member.getId(), turnContext.getActivity().getRecipient().getId())
            ).map(channel -> turnContext.sendActivity(MessageFactory.text(welcomeText, welcomeText, null)))
            .collect(CompletableFutures.toFutureList()).thenApply(resourceResponses -> null);
    }
}

class EchoBot(ActivityHandler):
    async def on_members_added_activity(
        self, members_added: [ChannelAccount], turn_context: TurnContext
    ):
        for member in members_added:
            if member.id != turn_context.activity.recipient.id:
                await turn_context.send_activity("Hello and welcome!")

    async def on_message_activity(self, turn_context: TurnContext):
        return await turn_context.send_activity(
            MessageFactory.text(f"Echo: {turn_context.activity.text}")
        )