سيتم إيقاف "إجراءات المحادثة" في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على إنهاء إجراءات المحادثة.

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الشكل 1. هي فئة ألعاب تفاعلية يتم إنشاؤها باستخدام "لوحة الرسم التفاعلية".

"اللوحة التفاعلية" هي إطار عمل تم تصميمه في "مساعد Google" ويتيح لمطوّري البرامج إضافة تجارب مرئية غامرة إلى "المهام المتعلقة بالمحادثات". هذه التجربة المرئية هي تطبيق ويب تفاعلي يرسله "مساعد Google" كردّ على المستخدم في المحادثة. وعلى عكس الردود الغنية المضمّنة في محادثة "مساعد Google"، يتم عرض تطبيق الويب "لوحة الرسم التفاعلية" كمشاهدة ويب بملء الشاشة.

استخدِم "لوحة الرسم التفاعلية" إذا كنت تريد تنفيذ أيٍّ مما يلي في الإجراء:

  • إنشاء مرئيات بملء الشاشة
  • إنشاء تأثيرات متحركة وتأثيرات انتقالية مخصصة
  • إنشاء تمثيل بصري للبيانات
  • إنشاء تنسيقات مخصّصة وواجهة مستخدم تصويرية

الأجهزة المعتمدة

تتوفر "لوحة الرسم التفاعلية" حاليًا على الأجهزة التالية:

  • الشاشات الذكية
  • أجهزة جوّال تعمل بنظام التشغيل Android

آلية العمل

يتكون الإجراء الذي يستخدم "لوحة الرسم التفاعلية" من مكوّنين رئيسيين:

  • الإجراء المستند إلى المحادثة: إجراء يستخدم واجهة محادثة لتلبية طلبات المستخدمين. يمكنك استخدام أداة إنشاء الإجراءات أو SDK للإجراءات لإنشاء المحادثة.
  • تطبيق ويب: تطبيق ويب للواجهة الأمامية مع مرئيات مخصصة يرسلها إجراءك استجابةً للمستخدمين أثناء المحادثة. يمكنك إنشاء تطبيق الويب باستخدام تقنيات ويب مثل HTML وجافا سكريبت وCSS.

يُجري المستخدمون الذين يتفاعلون مع "لوحة الرسم التفاعلية" محادثة متبادلة مع "مساعد Google" لتحقيق الهدف. ومع ذلك، بالنسبة إلى "لوحة الرسم التفاعلية"، تحدث الجزء الأكبر من هذه المحادثة ضمن سياق تطبيق الويب. وعند ربط "إجراء المحادثة" بتطبيق الويب، يجب تضمين واجهة برمجة التطبيقات التفاعلية في رمز تطبيق الويب.

  • مكتبة Canvas التفاعلية: مكتبة JavaScript التي تُدرجها في تطبيق الويب لتفعيل الاتصال بين تطبيق الويب والإجراء القائم على المحادثة باستخدام واجهة برمجة تطبيقات. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على مستندات واجهة برمجة التطبيقات التفاعلية لـ Canvas.

بالإضافة إلى تضمين مكتبة "لوحة الرسم التفاعلية"، يجب عرض نوع الاستجابة Canvas في محادثتك لفتح تطبيق الويب على جهاز المستخدم. يمكنك أيضًا استخدام استجابة Canvas لتحديث تطبيق الويب بناءً على ملاحظات المستخدم.

  • Canvas: استجابة تتضمن عنوان URL لتطبيق الويب وبيانات لتمريره. يمكن لأداة إنشاء الإجراءات تعبئة استجابة Canvas تلقائيًا بالقصد من المطابقة وبيانات المشهد الحالي لتحديث تطبيق الويب. وبدلاً من ذلك، يمكنك إرسال استجابة Canvas من الردّ التلقائي على الويب باستخدام مكتبة تنفيذ Node.js. لمزيد من المعلومات، يُرجى الاطِّلاع على مطالبات Canvas.

لتوضيح كيفية عمل لوحة الرسم التفاعلية، تخيل إجراءً افتراضيًا يُطلق عليه اسم الألوان الرائعة يغير لون شاشة الجهاز إلى اللون الذي يحدده المستخدم. بعد أن يستدعي المستخدم الإجراء، يحدث التدفق التالي:

  1. قال المستخدم، "تحويل الشاشة إلى اللون الأزرق" إلى الجهاز المزوّد بخدمة "مساعد Google".
  2. توجّه منصّة "المهام مع مساعد Google" طلب المستخدم إلى منطق المحادثة لمطابقة نية الشراء.
  3. تتطابق المنصة مع الهدف مع مشهد الإجراء، ما يؤدي إلى تشغيل حدث وإرسال استجابة Canvas إلى الجهاز. يحمّل الجهاز تطبيق ويب باستخدام عنوان URL تم تقديمه في الاستجابة (إذا لم يتم تحميله بعد).
  4. عند تحميل تطبيق الويب، يتم تسجيل عمليات الاستدعاء باستخدام واجهة برمجة التطبيقات التفاعلية "لوحة الرسم التفاعلية". إذا كانت استجابة "لوحة الرسم" تحتوي على الحقل data، يتم تمرير قيمة الكائن للحقل data إلى معاودة الاتصال المسجّلة في onUpdate لتطبيق الويب. في هذا المثال، يرسل منطق المحادثة استجابة Canvas مع حقل بيانات يتضمن متغيرًا بقيمة blue.
  5. عند تلقي القيمة data للاستجابة Canvas، يمكن لمعاودة الاتصال على onUpdate تنفيذ منطق مخصص لتطبيق الويب وإجراء التغييرات المحددة. في هذا المثال، تقرأ معاودة الاتصال على onUpdate اللون من data وتتحول الشاشة إلى اللون الأزرق.

التنفيذ من جانب العميل والخادم

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

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

إذا اخترت الإنشاء باستخدام تنفيذ البرنامج (متوفّر حاليًا في "معاينة مطوّر البرامج")، يمكنك استخدام واجهات برمجة تطبيقات جديدة من جانب العميل لإنشاء منطق "الإجراء" الخاص بك حصريًا في تطبيق الويب، ما يسهِّل تجربة التطوير، ويحد من وقت الاستجابة بين المنعطفات الحوارية، ويتيح لك استخدام إمكانات الجهاز. وإذا لزم الأمر، يمكنك أيضًا التبديل إلى المنطق من جانب الخادم من البرنامج.

لمزيد من المعلومات حول الإمكانيات من جهة العميل، يُرجى الاطّلاع على الإنشاء باستخدام الوفاء من جهة العميل.

الخطوات التالية

لمعرفة كيفية إنشاء تطبيق ويب لـ "لوحة الرسم التفاعلية"، يمكنك الاطّلاع على تطبيقات الويب.

للاطّلاع على الرمز الخاص بإجراء "اللوحة التفاعلية" الكامل، يُرجى الاطّلاع على النموذج على GitHub.