Scene

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

تمثيل YAML 
onEnter: 
  object (EventHandler)
intentEvents: 
  - object (IntentEvent)
conditionalEvents: 
  - object (ConditionalEvent)
slots: 
  - object (Slot)
onSlotUpdated: 
  object (EventHandler)
الحقول
onEnter

object (EventHandler)

المعالجة التي سيتم استدعاؤها عند الانتقال إلى هذا المشهد.
intentEvents[]

object (IntentEvent)

قائمة الأحداث التي يتم تشغيلها استنادًا إلى الأهداف. يمكن بدء هذه الأحداث في أي وقت بعد استدعاء معالج on_load. ملاحظة مهمة: تحدّد هذه الأحداث مجموعة الأهداف المرتبطة بهذا المشهد، وستحظى بالأولوية على أي أحداث محدّدة عالميًا لها الأهداف نفسها أو العبارات التي تؤدّي إلى الأحداث. يجب أن تكون أسماء الأهداف فريدة ضمن مشهد.
conditionalEvents[]

object (ConditionalEvent)

تمثّل هذه السمة قائمة الأحداث المطلوب تشغيلها استنادًا إلى العبارات الشرطية. يتم تقييمها بعد ملء النموذج أو مباشرة بعد on_load إذا لم يكن هذا المشهد يحتوي على نموذج (يتم التقييم مرة واحدة فقط). سيتم تشغيل أول حدث مطابق فقط.
slots[]

object (Slot)

تم ترتيب قائمة الخانات. تحدّد كل خانة نوع البيانات التي سيتم تحليلها وإعدادها لتخصيص تجربة درجة الدقة هذه (مثل الطلبات).
onSlotUpdated

object (EventHandler)

يتم استدعاء المعالج عند حدوث تغيير في حالة خانة لا ناتجة عن التحديثات داخل معالِج آخر. يتيح ذلك إلغاء صلاحية الخانات أو إلغاء صلاحية المشهد أو إجراء تغييرات أخرى على حالة المشهد.

الحيز

إعدادات خانة. الشرائح هي وحدات فردية من البيانات يمكن ملؤها بلغة طبيعية (أي معلَمات الغرض) ومعلَمات الجلسات وغيرها من المصادر.

تمثيل YAML 
name: string
type: 
  object (ClassReference)
required: boolean
promptSettings: 
  object (PromptSettings)
commitBehavior: 
  object (CommitBehavior)
config: value
defaultValue: 
  object (DefaultValue)
الحقول
name

string

مطلوب. اسم الخانة
type

object (ClassReference)

مطلوب. تحدد نوع البيانات لهذه الخانة.
required

boolean

اختياريّ. يشير إلى ما إذا كان يجب ملء الخانة قبل التقدّم. ستؤدي الخانات المطلوبة غير المكتمِلة إلى عرض إشعار قابل للتخصيص للمستخدم.
promptSettings

object (PromptSettings)

اختياريّ. لتسجيل المطالبات لمراحل مختلفة من ملء الخانات.
commitBehavior

object (CommitBehavior)

اختياريّ. سلوك التنفيذ المرتبط بالخانة
config

value (Value format)

اختياريّ. إعدادات إضافية مرتبطة بالخانة المستخدَمة لملء الخانة ويكون تنسيق الإعداد خاصًا بنوع الخانة. يمكن إضافة مراجع الموارد إلى مَعلمة المستخدِم أو الجلسة إلى هذه الإعدادات. هذا الإعداد مطلوب لملء الخانات ذات الصلة بالمعاملات وتفاعل المستخدمين.

مثال: بالنسبة إلى خانة من النوع actions.type.CompletePurchaseValue، تقترح الإعدادات التالية طلبًا رقميًا جيدًا مع إشارة إلى مَعلمة الجلسة التي يحدّدها العميل userSelectedSkuId:

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } }
defaultValue

object (DefaultValue)

اختياريّ. إعدادات لتعبئة قيمة تلقائية لهذه الخانة

PromptSettings

مكان واحد يتم فيه تحديد مطالبات الخانات

تمثيل YAML 
initialPrompt: 
  object (EventHandler)
noMatchPrompt1: 
  object (EventHandler)
noMatchPrompt2: 
  object (EventHandler)
noMatchFinalPrompt: 
  object (EventHandler)
noInputPrompt1: 
  object (EventHandler)
noInputPrompt2: 
  object (EventHandler)
noInputFinalPrompt: 
  object (EventHandler)
الحقول
initialPrompt

object (EventHandler)

طلب قيمة الخانة نفسها مثال: "ما الحجم الذي تريده؟"
noMatchPrompt1

object (EventHandler)

يتم عرض هذا الطلب عندما لا يتطابق إدخال المستخدم مع نوع القيمة المتوقّعة للخانة لأول مرة. مثال: "عذرًا، لم أفهم ذلك."
noMatchPrompt2

object (EventHandler)

يتم عرض هذا الطلب عندما لا يتطابق إدخال المستخدم مع نوع القيمة المتوقّعة للخانة للمرة الثانية. مثال: "عذرًا، لم أفهم ذلك."
noMatchFinalPrompt

object (EventHandler)

يتم عرض هذا الطلب عندما لا يتطابق إدخال المستخدم مع نوع القيمة المتوقّعة للخانة في آخر مرة. مثال: "عذرًا، لم أفهم ذلك."
noInputPrompt1

object (EventHandler)

طلب إعطاء عندما لا يقدّم المستخدم إدخالاً لأول مرة مثال: "عذرًا، لم أفهم ذلك."
noInputPrompt2

object (EventHandler)

يتم عرض هذا الطلب عندما لا يقدّم المستخدم إدخالاً للمرة الثانية. مثال: "عذرًا، لم أفهم ذلك."
noInputFinalPrompt

object (EventHandler)

يتم عرض هذا الطلب عندما لا يقدّم المستخدم إدخالاً للمرة الأخيرة. مثال: "عذرًا، لم أفهم ذلك."

CommitBehavior

رسالة تصف سلوك التنفيذ المرتبط بالخانة بعد أن يتم ملؤها بنجاح.

تمثيل YAML 
writeSessionParam: string
الحقول
writeSessionParam

string

مَعلمة الجلسة اللازمة لكتابة قيمة الخانة بعد تعبئتها. يُرجى العلم أنّ المسارات المدمجة غير متاحة حاليًا. "$$" تُستخدم لكتابة قيمة الخانة على معلمة جلسة بنفس اسم الفتحة. على سبيل المثال: writeSessionParam = "fruit" مع "$session.params.fruit". writeSessionParam = "تذكرة" مع "$session.params.ticket".

DefaultValue

إعدادات لتعبئة قيمة تلقائية لهذه الخانة

تمثيل YAML 
sessionParam: string
constant: value
الحقول
sessionParam

string

اختياريّ. معلمة الجلسة المطلوب استخدامها لإعداد قيمة الخانة، إذا كانت لها قيمة غير فارغة. يجب أن يتطابق نوع القيمة مع نوع الخانة. يُرجى العلم أنّ المسارات المدمجة غير متاحة حاليًا. على سبيل المثال: sessionParam = "fruit" يتجاوب مع $session.params.fruit. sessionParam = "ticket" يتجاوب مع $session.params.ticket.
constant

value (Value format)

اختياريّ. قيمة تلقائية ثابتة للخانة. لن يتم استخدام هذه السمة إلا إذا لم تتم تعبئة قيمة لهذه الخانة من خلال sessionParam. يجب أن يتطابق نوع هذه القيمة مع نوع الخانة.