SkillDialog 類別

  • 參考
套件:
com.microsoft.bot.dialogs
Maven 成品:
com.microsoft.bot:bot-dialogs:4.14.3

public class SkillDialog
extends Dialog

特製化 Dialog，可將遠端呼叫包裝至技能。 BeginDialog 中的 options 參數必須是具有對話框初始參數的 BeginSkillDialogOptions 實例。

建構函式摘要

建構函式 Description
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

beginDialog beginDialog continueDialog endDialog getId getTelemetryClient getVersion innerRun onComputeId onDialogEvent onPostBubbleEvent onPreBubbleEvent repromptDialog resumeDialog resumeDialog run setId setTelemetryClient

方法繼承來源 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 - 對話框的識別碼。

方法詳細資料

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。

適用於