Dialog 类

public static final DialogTurnResult END_OF_TURN

一个 DialogTurnResult，指示当前对话框仍然处于活动状态，并等待用户下一轮输入。

public Dialog(String dialogId)

初始化 Dialog 类的新实例。

参数:

public CompletableFuture beginDialog(DialogContext dc)

启动对话并将其推送到对话堆栈时调用。

参数:

返回:

public abstract CompletableFuture beginDialog(DialogContext dc, Object options)

启动对话并将其推送到对话堆栈时调用。

参数:

返回:

public CompletableFuture continueDialog(DialogContext dc)

当对话框为 _continued_时调用，其中它是活动对话，用户使用新活动进行答复。

如果此方法未重写，则当用户答复时，对话框会自动结束。

参数:

返回:

public CompletableFuture endDialog(TurnContext turnContext, DialogInstance instance, DialogReason reason)

对话框结束时调用。

参数:

返回:

public String getId()

获取对话框的 ID。

返回:

public BotTelemetryClient getTelemetryClient()

获取用于日志记录的 BotTelemetryClient。

返回:

public String getVersion()

获取表示此对话框版本的唯一字符串。 如果对话框系统之间的版本更改将发出 DialogChanged 事件。

返回:

protected static CompletableFuture innerRun(TurnContext turnContext, String dialogId, DialogContext dialogContext, DialogStateManagerConfiguration stateConfiguration)

使用 Dialog 和 DialogManager 运行的共享实现。

参数:

返回:

protected String onComputeId()

计算对话框的 ID。

返回:

public CompletableFuture onDialogEvent(DialogContext dc, DialogEvent e)

使用“DialogContext.emitEvent（）”通过当前对话或当前对话启动的对话引发事件时调用。

参数:

返回:

protected CompletableFuture onPostBubbleEvent(DialogContext dc, DialogEvent e)

在向所有家长冒泡事件后调用，但未处理。

这是为事件执行默认处理逻辑的好位置。 返回“true”将阻止子对话对事件的任何处理。

参数:

返回:

protected CompletableFuture onPreBubbleEvent(DialogContext dc, DialogEvent e)

在将事件气泡到其父级之前调用。

这是执行事件截获的好位置，因为返回“true”将阻止事件进一步浮升到对话父级，并且还会阻止任何子对话执行其默认处理。

参数:

返回:

public CompletableFuture repromptDialog(TurnContext turnContext, DialogInstance instance)

当对话框应重新提示用户输入时调用。

参数:

返回:

public CompletableFuture resumeDialog(DialogContext dc, DialogReason reason)

当子对话完成此轮次时调用，将控件返回到此对话。

通常，子对话是通过调用 beginDialog(DialogContext dc, Object options) 启动的，但是，如果调用 replaceDialog(String dialogId) 方法，则逻辑子对话可能与原始对话不同。

如果此方法未重写，则当用户答复时，对话框会自动结束。

参数:

返回:

public CompletableFuture resumeDialog(DialogContext dc, DialogReason reason, Object result)

当子对话完成此轮次时调用，将控件返回到此对话。

通常，子对话是通过调用 beginDialog(DialogContext dc, Object options) 启动的，但是，如果调用 replaceDialog(String dialogId, Object options) 方法，则逻辑子对话可能与原始对话不同。

如果此方法未重写，则当用户答复时，对话框会自动结束。

参数:

返回:

public static CompletableFuture run(Dialog dialog, TurnContext turnContext, StatePropertyAccessor accessor)

创建对话堆栈并启动对话，将其推送到堆栈上。

参数:

返回:

public void setId(String withId)

设置对话框的 ID。

参数:

public void setTelemetryClient(BotTelemetryClient withTelemetryClient)

设置要用于日志记录的 BotTelemetryClient。

参数: