Dialog الفصل

‏‏المرجع

الدالمنشئ

Dialog(dialog_id: str)

المعلمات

الاسم	الوصف
dialog_id مطلوب

الأساليب

begin_dialog	يتم استدعاء الأسلوب عند دفع مربع حوار جديد إلى المكدس ويتم تنشيطه. :p أرام dialog_context: سياق مربع الحوار للانعطاف الحالي للمحادثة. :p خيارات aram: (اختياري) وسيطة (وسيطات) إضافية لتمريرها إلى مربع الحوار الذي يتم بدء تشغيله.
continue_dialog	يتم استدعاء الأسلوب عندما يكون مثيل مربع الحوار هو مربع الحوار "الحالي" ويرد المستخدم بنشاط جديد. سيستمر مربع الحوار بشكل عام في تلقي ردود المستخدم حتى يستدعي إما end_dialog() أو begin_dialog(). إذا لم يتم تنفيذ هذا الأسلوب، إنهاء مربع الحوار تلقائيا عندما يرد المستخدم. :p أرام dialog_context: سياق مربع الحوار للانعطاف الحالي للمحادثة. :أعاد:
end_dialog
get_version
on_dialog_event	يتم استدعاؤه عند رفع حدث، باستخدام DialogContext.emitEvent()، إما بواسطة مربع الحوار الحالي أو مربع الحوار الذي بدأه مربع الحوار الحالي.
reprompt_dialog
resume_dialog	يتم استدعاء الأسلوب عند إرجاع مثيل من مربع الحوار إلى من مربع حوار آخر بدأه المثيل الحالي باستخدام begin_dialog(). إذا لم يتم تنفيذ هذا الأسلوب، إنهاء مربع الحوار تلقائيا باستدعاء end_dialog(). سيتم تمرير أي نتيجة تم تمريرها من مربع الحوار المسمى إلى أصل مربع الحوار الحالي. :p أرام dialog_context: سياق مربع الحوار للانعطاف الحالي للمحادثة. سبب :p أرام: سبب استئناف مربع الحوار. نتيجة :p aram: (اختياري) القيمة التي تم إرجاعها من مربع الحوار الذي تم استدعاؤه. يعتمد نوع القيمة التي تم إرجاعها على مربع الحوار الذي تم استدعاؤه. :أعاد:

begin_dialog

يتم استدعاء الأسلوب عند دفع مربع حوار جديد إلى المكدس ويتم تنشيطه. :p أرام dialog_context: سياق مربع الحوار للانعطاف الحالي للمحادثة. :p خيارات aram: (اختياري) وسيطة (وسيطات) إضافية لتمريرها إلى مربع الحوار الذي يتم بدء تشغيله.

abstract async begin_dialog(dialog_context: DialogContext, options: object = None)

المعلمات

الاسم	الوصف
dialog_context مطلوب
options	القيمة الافتراضية: None

continue_dialog

يتم استدعاء الأسلوب عندما يكون مثيل مربع الحوار هو مربع الحوار "الحالي" ويرد المستخدم بنشاط جديد. سيستمر مربع الحوار بشكل عام في تلقي ردود المستخدم حتى يستدعي إما end_dialog() أو begin_dialog(). إذا لم يتم تنفيذ هذا الأسلوب، إنهاء مربع الحوار تلقائيا عندما يرد المستخدم. :p أرام dialog_context: سياق مربع الحوار للانعطاف الحالي للمحادثة. :أعاد:

async continue_dialog(dialog_context: DialogContext)

المعلمات

الاسم	الوصف
dialog_context مطلوب

end_dialog

async end_dialog(context: TurnContext, instance: DialogInstance, reason: DialogReason)

المعلمات

الاسم	الوصف
context مطلوب
instance مطلوب
reason مطلوب

get_version

get_version() -> str

on_dialog_event

يتم استدعاؤه عند رفع حدث، باستخدام DialogContext.emitEvent()، إما بواسطة مربع الحوار الحالي أو مربع الحوار الذي بدأه مربع الحوار الحالي.

async on_dialog_event(dialog_context: DialogContext, dialog_event: DialogEvent) -> bool

المعلمات

الاسم	الوصف
dialog_context مطلوب	سياق مربع الحوار الخاص بدور المحادثة الحالي.
dialog_event مطلوب	الحدث الذي يتم رفعه.

المرتجعات

النوع	الوصف
	صحيح إذا تم التعامل مع الحدث بواسطة مربع الحوار الحالي ويجب أن يتوقف الخفقان.

reprompt_dialog

async reprompt_dialog(context: TurnContext, instance: DialogInstance)

المعلمات

الاسم	الوصف
context مطلوب
instance مطلوب

resume_dialog

يتم استدعاء الأسلوب عند إرجاع مثيل من مربع الحوار إلى من مربع حوار آخر بدأه المثيل الحالي باستخدام begin_dialog(). إذا لم يتم تنفيذ هذا الأسلوب، إنهاء مربع الحوار تلقائيا باستدعاء end_dialog(). سيتم تمرير أي نتيجة تم تمريرها من مربع الحوار المسمى إلى أصل مربع الحوار الحالي. :p أرام dialog_context: سياق مربع الحوار للانعطاف الحالي للمحادثة. سبب :p أرام: سبب استئناف مربع الحوار. نتيجة :p aram: (اختياري) القيمة التي تم إرجاعها من مربع الحوار الذي تم استدعاؤه. يعتمد نوع القيمة التي تم إرجاعها على مربع الحوار الذي تم استدعاؤه. :أعاد:

async resume_dialog(dialog_context: DialogContext, reason: DialogReason, result: object)

المعلمات

الاسم	الوصف
dialog_context مطلوب
reason مطلوب
result مطلوب

السمات

id

telemetry_client

يحصل على عميل بيانات تتبع الاستخدام لتسجيل الأحداث.

end_of_turn

end_of_turn = <botbuilder.dialogs.dialog_turn_result.DialogTurnResult object>

الملاحظات

هل كانت هذه الصفحة مفيدة؟