لوحة الرسم التفاعلية (Dialogflow)

الكائن interactiveCanvas هو واجهة إجراء المحادثة الذي يتم توفيره داخل تطبيق الويب.

الطُرق

جاهز

ready(callbacks) returns undefined

يتم الاتصال من خلال تطبيق الويب Interactive Canvas بعد تحميله لتسجيل طلبات معاودة الاتصال.

المَعلمات
callbacks InteractiveCanvasCallbacks

يشير ذلك المصطلح إلى كائن يحتوي على عمليات استرجاع الطريقة.

sendTextQuery

sendTextQuery(textQuery) returns Promise<state>

لإرسال طلب بحث نصي إلى إجراء المحادثة.

المَعلمات
textQuery string

طلب البحث المطلوب إرساله إلى إجراء المحادثة.

state string

يجب استخدام إحدى السمات التالية:

READY: يمكن للمنصة قبول الطلبات.

BLOCKED: هناك طلب بحث أثناء الرحلة الجوية وسيتم تجاهل طلب البحث الجديد.

UNKNOWN: تعذّر تحديد حالة طلب البحث الحالية.

getHeaderHeightPx

getHeaderHeightPx() returns Promise<height>

تحدد ارتفاع العنوان أعلى شاشة العرض.

المَعلمات
height number

الارتفاع بالبكسل.

InteractiveCanvasCallbacks

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

onUpdate

onUpdate(data) returns undefined

يتم استدعاء هذا الإجراء عند إرسال HtmlResponse من إجراء المحادثة. بعد نهاية استدعاء الدالة، يبدأ تحويل النص إلى كلام على الفور.

المَعلمات
data Object

تم إرسال البيانات المعدّلة من خلال الرد التلقائي على الويب.

onTtsMark

onTtsMark(markName) returns undefined

معاودة الاتصال التي تم استدعاؤها أثناء تشغيل تقنية TTS.

العلامات الخاصة التي يتم تشغيلها دائمًا:

  • تشير السمة START إلى بداية تقنية TTS.
  • تشير السمة END إلى نهاية "تحويل النص إلى كلام".
  • تشير القيمة ERROR إلى خطأ أثناء تشغيل تقنية TTS.

يمكنك أيضًا تحديد علامات مخصّصة باستخدام SSML والعلامة <mark>، مثل <mark name="custom"/>.

المَعلمات
markName string

تم استدعاء اسم العلامة أثناء تشغيل تقنية TTS.