يحدد نموذج الاستدعاء كيفية استدعاء الإجراءات في مشروعك. عندما يستدعي المستخدمون إجراءً، فإنهم يبدؤون محادثة معه، وهو محدّدة في نموذج المحادثة. يمكنك تحديد عدد الاستدعاءات بالطرق التالية:
الاستدعاء الرئيسي: هو الاستدعاء الوحيد المطلوب لمشروع الإجراءات. يقول المستخدمون عبارة على غرار "Ok Google، أريد التحدّث إلى <display name>" لمطابقة هذا الهدف، والذي تتعامل معه عادةً من خلال تحية المستخدم برسالة ترحيب.
استدعاءات الروابط المؤدية إلى صفحات في التطبيق: هذه استدعاءات اختيارية تتيح لك تحديد عبارات التدريب في حسب النية بالشراء، بحيث يمكن للمستخدمين إنشاء رابط لموضع معين في جزء محدد من محادثة. يمكن للمستخدمين قول عبارة مشابهة لـ "Ok Google، تحدث إلى <الاسم المعروض> إلى <deep link مصادقة>" لمطابقة هذه الأنواع من الأهداف (على سبيل المثال، "Ok Google، التحدث إلى حقائق عن Google للحصول على الحقائق")
أهداف مضمَّنة: هذه استدعاءات اختيارية تتيح لك الاستفادة من استدعاءات النظام نماذج الاستدعاء. من خلال إعلان الدعم لهدف مدمج، يمكن للمستخدمين اكتشاف واستدعاء مشروع الإجراءات الخاص بك دون الحاجة إلى تحديد اسم العرض. على سبيل المثال، يمكن للمستخدمين قول "Ok Google، أريد تشغيل لعبة". يمكن أن يقدّم "مساعد Google" الإجراء الخاص بك كخيار للاستدعاء.
إنشاء الاستدعاء الرئيسي
يتضمّن كل مشروع في "المهام" استدعاءً تلقائيًا رئيسيًا يعمل كإعداد تلقائي.
نقطة الدخول إلى مشروع الإجراءات.النموذج اللغوي لهذا الاستدعاء
بالاسم المعروض لمشروعك، لذلك يحتاج المستخدمون فقط إلى قول
عبارة تشبه "Ok Google، التحدّث إلى <الاسم المعروض>" لاستخدام هذه
. وعند تنفيذ المستخدمين لـ "الإجراءات" على هذا النحو، يستخدم "مساعد Google"
يتطابق وقت التشغيل مع هدف النظام actions.intent.MAIN.
لإنشاء الاستدعاء الرئيسي:
إنشاء عمليات استدعاء الروابط المؤدية إلى صفحات في التطبيق
لإنشاء عمليات استدعاء الروابط المؤدية إلى صفحات في التطبيق، يمكنك إنشاء نوايا المستخدمين العالمية من خلال التدريب. العبارات التي تحدد البيانات التي أدخلها المستخدم والتي تريد ضبطها لرابط الصفحة في التطبيق. يقول المستخدمون إنّ الاسم المعروض الخاص بك مع عبارة الربط بصفحة معيّنة مطلوب حملها استدعاء رابط لصفحة في التطبيق (على سبيل المثال، "Ok Google، تحدث إلى <display name> إلى <deep link terms>")
إنشاء استدعاءات ضمنية
يتيح الاستدعاء الضمني للمستخدمين استدعاء الإجراء الخاص بك بدون استخدام اسم العرض. للعثور على المهام المطابقة، تستخدم Google إشارات، مثل المستخدمين. إخبار "مساعد Google" بتنفيذ إجراءات مشابهة لإحدى عبارات الاستدعاء لنواياك التي تم ضبطها، أو عندما يكون المستخدِم في سياق تكون فيه إجراءاتك سيكون مناسبًا.
التعامل مع أحداث الاستدعاء
عندما يطابق "مساعد Google" أحد الأهداف العالمية، فإنّه يؤدي إلى تشغيل حدث يمكنها المعالجة باستخدام معالج. توضّح الأقسام التالية شكل المعالج يمكنك تنفيذها (يمكنك اختيار واحد أو أي مزيج من الثلاثة).
تشغيل ردّ تلقائي على الويب
يمكن لمعالِج intent أن يفوّض خدمة ويب عن طريق تشغيل حدث ردّ تلقائي على الويب. لتشغيل ردّ تلقائي على الويب وتجهيز خدمة ويب لمعالجة الاستدعاء:
الطلبات
يمكن أن يردّ معالج intent بطلب ثابت. عادةً، مطالبات ترحّب أغراض الاستدعاء بالمستخدم أو توجّهه إلى طريقة استخدام الإجراء والاستجابة بالمعلومات التي يحتاجها المستخدم على الفور (إجراءات لقطة واحدة).
للتعامل مع مطابقة الرغبة في الاستدعاء من خلال الطلب:
الانتقال إلى مشهد
يمكن أن ينتقل معالج الأهداف إلى مشهد لمعالجة الاستدعاء المطابق. والنية. يمنحك هذا أكبر قدر من المرونة لتنفيذ المنطق. للانتقال إلى مشهد: