EventHandler

candidates: 
  - object (StaticPromptCandidate)

object (StaticPromptCandidate)

قائمة بالطلبات المرشحة التي سيتم إرسالها إلى العميل. ويتضمّن كل طلب أداة اختيار لتحديد وقت استخدامه. سيتم إرسال أداة الاختيار الأولى التي تطابق أحد الطلبات وتجاهل الباقي.

selector: 
  object (Selector)
promptResponse: 
  object (StaticPromptResponse)

object (Selector)

اختياريّ. معايير ما إذا كان هذا الطلب يتطابق مع طلب معيّن. إذا كانت أداة الاختيار فارغة، سيتم دائمًا تشغيل هذا الطلب.

object (StaticPromptResponse)

تمثّل هذه السمة استجابة الطلب المرتبطة بأداة الاختيار.

surfaceCapabilities: 
  object (SurfaceCapabilities)

object (SurfaceCapabilities)

مجموعة إمكانيات العرض المطلوبة

capabilities: 
  - enum (Capability)

enum (Capability)

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

firstSimple: 
  object (StaticSimplePrompt)
content: 
  object (StaticContentPrompt)
lastSimple: 
  object (StaticSimplePrompt)
suggestions: 
  - object (Suggestion)
link: 
  object (StaticLinkPrompt)
override: boolean
canvas: 
  object (StaticCanvasPrompt)

object (StaticSimplePrompt)

اختياريّ. أول رد صوتي ونص فقط.

object (StaticContentPrompt)

اختياريّ. محتوى مثل بطاقة أو قائمة أو وسائط لعرضها للمستخدم.

object (StaticSimplePrompt)

اختياريّ. آخر رد صوتي ونص فقط.

object (Suggestion)

اختياريّ. سيتم عرض الاقتراحات للمستخدم والتي ستظهر دائمًا في نهاية الردّ. إذا كان الحقل append في الطلب الذي يتضمّن الطلب هو true، ستتم إضافة العناوين المحدَّدة في هذا الحقل إلى العناوين المحدَّدة في أي طلبات اقتراحات محدَّدة مسبقًا، وستتم إزالة القيم المكرّرة.

object (StaticLinkPrompt)

اختياريّ. شريحة اقتراح إضافية يمكن أن تربط بالتطبيق أو الموقع الإلكتروني المرتبط. سيتم عرض الشريحة بعنوان "فتح ". 20 حرفًا كحد أقصى

boolean

اختياريّ. وضع لكيفية دمج هذه الرسائل مع الرسائل المحددة مسبقًا. سيمحو true جميع الرسائل المحدَّدة مسبقًا (الأولى والأخيرة البسيطة والأخيرة ورابط المحتوى والاقتراحات ولوحة الرسم) وسيضيف الرسائل المحدَّدة في هذا الطلب. سيضيف false الرسائل المحدَّدة في هذا الطلب إلى الرسائل المحدَّدة في الردود السابقة. سيؤدي ضبط هذا الحقل على false إلى تفعيل الإلحاق ببعض الحقول داخل "الطلبات البسيطة" ومطالبة "الاقتراحات" و"طلب لوحة الرسم" (جزء من مطالبة المحتوى). سيتم دائمًا استبدال رسائل "المحتوى" و"الروابط" إذا تم تحديدها في الطلب. القيمة التلقائية هي false.

object (StaticCanvasPrompt)

رد يتم استخدامه في تجربة اللوحة التفاعلية.

variants: 
  - object (Variant)

object (Variant)

قائمة بالصيغ المحتملة

speech: string
text: string

string

اختياريّ. تمثل الكلام الذي سيتم قوله للمستخدم. يمكن أن يكون SSML أو تحويل النص إلى كلام. سيتم تلقائيًا إلحاق الكلام بالكلام في الطلب البسيط السابق. إذا كان الحقل override في الطلب الذي يتضمّن الرسالة هو true، سيلغي الكلام المحدَّد في هذا الحقل كلام الطلب البسيط السابق.

string

اختياريّ. النص الذي سيتم عرضه في فقاعة المحادثة. وفي حال عدم إتاحته، سيتم عرض عرض لحقل الكلام أعلاه. يقتصر على 640 حرفًا. سيتم تلقائيًا إلحاق النص بنص الطلب البسيط السابق. إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو true، سيلغي النص المحدَّد في هذا الحقل نص الطلب البسيط السابق.

# Union field content can be only one of the following:
card: 
  object (StaticCardPrompt)
image: 
  object (StaticImagePrompt)
table: 
  object (StaticTablePrompt)
media: 
  object (StaticMediaPrompt)
list: 
  object (StaticListPrompt)
collection: 
  object (StaticCollectionPrompt)
collectionBrowse: 
  object (StaticCollectionBrowsePrompt)
# End of list of possible types for union field content.

object (StaticCardPrompt)

بطاقة أساسية

object (StaticImagePrompt)

صورة.

object (StaticTablePrompt)

بطاقة جدول.

object (StaticMediaPrompt)

استجابة تشير إلى مجموعة من الوسائط التي سيتم تشغيلها.

object (StaticListPrompt)

بطاقة لعرض قائمة بالخيارات للاختيار منها

object (StaticCollectionPrompt)

بطاقة تعرض قائمة بالخيارات للاختيار منها.

object (StaticCollectionBrowsePrompt)

بطاقة تعرض مجموعة من صفحات الويب المراد فتحها

title: string
subtitle: string
text: string
image: 
  object (StaticImagePrompt)
imageFill: enum (ImageFill)
button: 
  object (StaticLinkPrompt)

string

اختياريّ. العنوان العام للبطاقة.

string

اختياريّ. العنوان الفرعي للبطاقة

string

مطلوب. النص الأساسي للبطاقة مطلوب ما لم تكن الصورة موجودة. تتيح مجموعة محدودة من بنية markdown للتنسيق.

object (StaticImagePrompt)

اختياريّ. صورة الجزء الرئيسي للبطاقة تم تثبيت الارتفاع على 192 وحدة بكسل مستقلة الكثافة (dp).

enum (ImageFill)

اختياريّ. طريقة ملء خلفية الصورة

object (StaticLinkPrompt)

اختياريّ. زرّ يمكن النقر عليه لعرضه في البطاقة

url: string
alt: string
height: integer
width: integer

string

مطلوب. عنوان URL المصدر الخاص بالصورة يمكن أن تكون الصور بتنسيق JPG وPNG وGIF (متحرّكة وغير متحركة). مثلاً: https://www.agentx.com/logo.png

string

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

integer

اختياريّ. ارتفاع الصورة بالبكسل.

integer

اختياريّ. عرض الصورة بالبكسل.

name: string
open: 
  object (OpenUrl)

string

اسم الرابط

object (OpenUrl)

تحدِّد هذه السياسة السلوك عندما يفتح المستخدم الرابط.

url: string
hint: enum (UrlHint)

string

حقل عنوان URL الذي يمكن أن يكون أيًا مما يلي: - http/https عناوين URL لفتح تطبيق مرتبط بتطبيق أو صفحة ويب

enum (UrlHint)

يشير هذا الحقل إلى تلميح لنوع عنوان URL.

title: string
subtitle: string
image: 
  object (StaticImagePrompt)
columns: 
  - object (TableColumn)
rows: 
  - object (TableRow)
button: 
  object (StaticLinkPrompt)

string

اختياريّ. تمثّل هذه السمة العنوان العام للجدول. يجب تعيينه في حال ضبط الترجمة.

string

اختياريّ. عنوان فرعي للجدول.

object (StaticImagePrompt)

اختياريّ. صورة مرتبطة بالجدول

object (TableColumn)

اختياريّ. عناوين الأعمدة ومحاذاة الأعمدة

object (TableRow)

اختياريّ. بيانات الصف في الجدول يمكن ضمان عرض أول 3 صفوف، ولكن قد يتم اقتصاص الصفوف الأخرى على أسطح معيّنة. يُرجى إجراء الاختبار باستخدام المحاكي لمعرفة الصفوف التي سيتم عرضها لسطح معيَّن. وفي مساحات العرض التي تتيح ميزة WEB_BROWSER، يمكنك توجيه المستخدم إلى صفحة ويب تحتوي على المزيد من البيانات.

object (StaticLinkPrompt)

اختياريّ. زرّ

header: string
align: enum (HorizontalAlignment)

string

نص عنوان العمود

enum (HorizontalAlignment)

محاذاة أفقية لعمود w.r.t المحتوى إذا لم يتم تحديد ذلك، ستتم محاذاة المحتوى مع الحافة الأمامية.

cells: 
  - object (TableCell)
divider: boolean

object (TableCell)

الخلايا في هذا الصف. يتم ضمان عرض أول 3 خلايا، ولكن قد يتم اقتصاص الخلايا الأخرى على أسطح معيّنة. يُرجى الاختبار باستخدام المحاكي لمعرفة الخلايا التي سيتم عرضها على سطح معيَّن.

boolean

يشير إلى ما إذا كان يجب أن يكون هناك مُقسّم بعد كل صف.

text: string

string

المحتوى النصي للخلية.

mediaType: enum (MediaType)
startOffset: string
optionalMediaControls: 
  - enum (OptionalMediaControls)
mediaObjects: 
  - object (MediaObject)
repeatMode: enum (RepeatMode)

enum (MediaType)

نوع الوسائط لهذا الردّ.

string (Duration format)

إزاحة بدء كائن الوسائط الأول.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"

enum (OptionalMediaControls)

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

object (MediaObject)

قائمة بكائنات الوسائط.

enum (RepeatMode)

وضع التكرار لقائمة عناصر الوسائط.

name: string
description: string
url: string
image: 
  object (MediaImage)

string

اسم كائن الوسائط هذا.

string

وصف عنصر الوسائط هذا.

string

تمثّل هذه السمة عنوان URL الذي يشير إلى محتوى الوسائط.

object (MediaImage)

الصورة التي سيتم عرضها مع بطاقة الوسائط.

# Union field image can be only one of the following:
large: 
  object (StaticImagePrompt)
icon: 
  object (StaticImagePrompt)
# End of list of possible types for union field image.

object (StaticImagePrompt)

صورة كبيرة، مثل غلاف الألبوم، وما إلى ذلك

object (StaticImagePrompt)

رمز صورة صغير يتم عرضه على يمين العنوان. ويتم تغيير حجمها إلى 36×36 بكسل مستقل الكثافة.

title: string
subtitle: string
items: 
  - object (ListItem)

string

اختياريّ. عنوان القائمة

string

اختياريّ. العنوان الفرعي للقائمة.

object (ListItem)

مطلوب. عناصر القائمة.

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

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

string

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

string

اختياريّ. النص الأساسي للعنصر

object (StaticImagePrompt)

اختياريّ. صورة العنصر

title: string
subtitle: string
items: 
  - object (CollectionItem)
imageFill: enum (ImageFill)

string

اختياريّ. تمثّل هذه السمة عنوان المجموعة.

string

اختياريّ. العنوان الفرعي للمجموعة.

object (CollectionItem)

مطلوب. عناصر المجموعة

enum (ImageFill)

اختياريّ. خيار عرض نوع الصورة

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

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

string

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

string

اختياريّ. النص الأساسي للعنصر

object (StaticImagePrompt)

اختياريّ. صورة العنصر

items: 
  - object (CollectionBrowseItem)
imageFill: enum (ImageFill)

object (CollectionBrowseItem)

العناصر في مجموعة التصفّح يجب أن يكون حجم القائمة في النطاق [2، 10].

enum (ImageFill)

خيار عرض الصور للصور في المجموعة.

title: string
description: string
footer: string
image: 
  object (StaticImagePrompt)
openUriAction: 
  object (OpenUrl)

string

مطلوب. عنوان عنصر المجموعة

string

تمثّل هذه السمة وصف عنصر المجموعة.

string

نص التذييل لعنصر المجموعة، ويتم عرضه أسفل الوصف. سطر واحد من النص، تم اقتطاعه بعلامة الحذف.

object (StaticImagePrompt)

صورة للسلعة في المجموعة

object (OpenUrl)

مطلوب. معرف موارد منتظم (URI) للفتح إذا تم تحديد العنصر.

title: string

string

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

url: string
data: 
  - value
suppressMic: boolean
sendStateDataToCanvasApp: boolean
enableFullScreen: boolean
continueTtsDuringTouch: boolean

string

مطلوب. عنوان URL لعرض الويب المطلوب تحميله.

value (Value format)

اختياريّ. يتم تمرير بيانات JSON إلى صفحة الويب للتجربة الشاملة كفعالية. إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو false من قيم البيانات المحدّدة في طلب لوحة الرسم هذا، ستتم إضافة قيم البيانات المحدّدة في طلبات "لوحة الرسم" السابقة.

boolean

اختياريّ. وتعني القيمة الحقيقية أنّه لن يتم فتح الميكروفون لالتقاط الإدخال بعد تقديم هذا الردّ الغامر للمستخدم.

boolean

اختياريّ. في حال true، يتم تضمين البيانات الوصفية المتعلقة بالمحادثة وإرسالها إلى تطبيق لوحة الرسم.

boolean

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

boolean

اختياريّ. إذا كانت القيمة هي true، لن تؤدي نقرات الشاشة إلى إيقاف ميزة "تحويل النص إلى كلام" في جلسة لوحة الرسم بأكملها. القيمة التلقائية: false.