SkillDialog 类

public class SkillDialog
extends Dialog

专用 Dialog,可以包装对技能的远程调用。 BeginDialog 中的 options 参数必须是具有对话框的初始参数的 BeginSkillDialogOptions 实例。

构造函数摘要

构造函数 说明
SkillDialog(SkillDialogOptions dialogOptions, String dialogId)

初始化 SkillDialog 类的新实例,以包装对技能的远程调用。

方法摘要

修饰符和类型 方法和描述
java.util.concurrent.CompletableFuture<DialogTurnResult> beginDialog(DialogContext dc, Object options)

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

java.util.concurrent.CompletableFuture<DialogTurnResult> continueDialog(DialogContext dc)

技能对话为 _continued_时调用,其中是活动对话,用户使用新活动进行答复。

java.util.concurrent.CompletableFuture<java.lang.Void> endDialog(TurnContext turnContext, DialogInstance instance, DialogReason reason)

技能对话结束时调用。

protected SkillDialogOptions getDialogOptions()

获取用于执行技能对话的选项。

protected boolean onValidateActivity(Activity activity)

验证在“继续”对话框中发送的活动。

java.util.concurrent.CompletableFuture<java.lang.Void> repromptDialog(TurnContext turnContext, DialogInstance instance)

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

java.util.concurrent.CompletableFuture<DialogTurnResult> resumeDialog(DialogContext dc, DialogReason reason, Object result)

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

方法继承自 Dialog

方法继承自 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

构造函数详细信息

SkillDialog

public SkillDialog(SkillDialogOptions dialogOptions, String dialogId)

初始化 SkillDialog 类的新实例,以包装对技能的远程调用。

参数:

dialogOptions - 用于执行技能对话的选项。
dialogId - 对话框的 ID。

方法详细信息

beginDialog

public CompletableFuture beginDialog(DialogContext dc, Object options)

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

替代:

SkillDialog.beginDialog(DialogContext dc, Object options)

参数:

dc - 当前对话轮次的 DialogContext
options - 可选,要传递给对话框的初始信息。

返回:

表示异步作的 CompletableFuture
     If the task is successful, the result indicates whether the dialog is
     still active after the turn has been processed by the dialog.

continueDialog

public CompletableFuture continueDialog(DialogContext dc)

技能对话为 _continued_时调用,其中是活动对话,用户使用新活动进行答复。

替代:

SkillDialog.continueDialog(DialogContext dc)

参数:

dc - 当前对话轮次的 DialogContext

返回:

表示异步作的 CompletableFuture
     If the task is successful, the result indicates whether the dialog is
     still active after the turn has been processed by the dialog. The
     result may also contain a return value.

endDialog

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

技能对话结束时调用。

替代:

SkillDialog.endDialog(TurnContext turnContext, DialogInstance instance, DialogReason reason)

参数:

turnContext - 此轮次的上下文对象。
instance - 与对话堆栈上此对话框实例关联的状态信息。
reason - 对话框结束的原因。

返回:

表示异步作的 CompletableFuture

getDialogOptions

protected SkillDialogOptions getDialogOptions()

获取用于执行技能对话的选项。

返回:

DialogOptions 值作为 SkillDialogOptions。

onValidateActivity

protected boolean onValidateActivity(Activity activity)

验证 ContinueDialog 期间发送的活动。

参数:

activity - 当前对话轮次的 Activity
             Override this method to implement a custom validator for the
             activity being sent during the ContinueDialog . This
             method can be used to ignore activities of a certain type if
             needed. If this method returns false, the dialog will end the
             turn without processing the activity.

返回:

如果活动有效,则为 true;否则为 false。

repromptDialog

public CompletableFuture repromptDialog(TurnContext turnContext, DialogInstance instance)

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

替代:

SkillDialog.repromptDialog(TurnContext turnContext, DialogInstance instance)

参数:

turnContext - 此轮次的上下文对象。
instance - 此对话框的状态信息。

返回:

表示异步作的 CompletableFuture

resumeDialog

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

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

替代:

SkillDialog.resumeDialog(DialogContext dc, DialogReason reason, Object result)

参数:

dc - 对话的当前轮次的对话上下文。
reason - 对话恢复的原因。
result - 可选,从调用的对话框返回的值。 返回的值的类型取决于子对话。

返回:

表示异步作的 CompletableFuture

适用于