تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة .
لوحة الرسم التفاعلية (Dialogflow)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الكائن interactiveCanvas
هو واجهة الإجراء الحواري
التي تتوفّر داخل تطبيق الويب
ملاحظة: الكائن interactiveCanvas
مرفق بكائن window
. إذا كنت
باستخدام إطار عمل واجهة أمامية لتطوير تطبيق الويب، يجب عليك التأكد من
يمكنك الوصول إلى window
لإعداد واجهة برمجة التطبيقات.
الطُرق
جاهز
ready(callbacks) returns undefined
يتم استدعاء هذه الدالة من خلال تطبيق الويب للوحة الرسم التفاعلية بعد تحميلها لتسجيل معاودة الاتصال.
ملاحظة: يجب استدعاء ready
API في تطبيق الويب ما إن
التحميل. وبخلاف ذلك، سيتم إغلاق الإجراء.
sendTextQuery
sendTextQuery(textQuery) returns Promise<state>
لإرسال طلب بحث نصي إلى إجراء المحادثة
المعلمات
textQuery
string
طلب البحث المراد إرساله إلى إجراء المحادثة.
state
string
يجب استخدام إحدى السمات التالية:
READY:
يمكن للمنصة قبول الطلبات.
BLOCKED:
هناك طلب بحث في المسار، وسيتم تجاهل الطلب الجديد.
UNKNOWN:
تعذّر تحديد حالة طلب البحث الحالية.
تنبيه: يجب أن يحتوي حقل "textQuery
" على 640 حرفًا أو أقل.
getHeaderHeightPx() returns Promise<height>
تحدد ارتفاع الرأس أعلى الشاشة.
المعلمات
height
number
الارتفاع بالبكسل.
InteractiveCanvasCallbacks
توفر لك عمليات الاسترداد هذه وسيلة للرد على المعلومات أو الطلبات
من إجراء المحادثة بينما توفر الطرق طريقة لإرسال
المعلومات أو الطلبات لإجراء المحادثة.
onUpdate
onUpdate(data) returns undefined
يتم استدعاء هذا الإجراء عند إرسال HtmlResponse
من إجراء المحادثة. بعد
نهاية استدعاء الدالة، ستبدأ تقنية تحويل النص إلى كلام على الفور.
المعلمات
data
Object
البيانات المعدّلة التي تم إرسالها من خلال الرد التلقائي على الويب
onTtsMark
onTtsMark(markName) returns undefined
معاودة الاتصال التي تم استدعاءها أثناء تشغيل تحويل النص إلى كلام
العلامات الخاصة التي يتم تشغيلها دائمًا:
تشير السمة START
إلى بداية تقنية "تحويل النص إلى كلام".
تشير السمة END
إلى نهاية تقنية "تحويل النص إلى كلام".
تشير السمة ERROR
إلى خطأ في تشغيل النص المحوَّل إلى كلام.
يمكنك أيضًا تحديد علامات مخصّصة باستخدام
شهادة SSML
والعلامة <mark>
، مثل <mark name="custom"/>
.
ملاحظة: لا يتم استدعاء علامات SSML في الحالات التالية:
قبل بدء تقنية تحويل النص إلى كلام، ينقر المستخدم على الميكروفون أو على لوحة الرسم التفاعلية
يستدعي العميل sendTextQuery
. تم إلغاء تحويل النص إلى كلام وأي علامات SSML في
ويتم تجاهل تحويل النص إلى كلام.
أثناء تحويل النص إلى كلام، ينقر المستخدم على الميكروفون أو يستدعي عميل "لوحة الرسم التفاعلية"
sendTextQuery
تتم مقاطعة تحويل النص إلى كلام وأي SSML متبقي
يتم تجاهل العلامات في تحويل النص إلى كلام.
المعلمات
markName
string
وضع علامة على الاسم الذي تم استدعاءه أثناء تشغيل تحويل النص إلى كلام
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]