الأهداف المدمجة للإجراءات في التطبيقات

إنّ الأغراض المضمّنة (BII) تسمح لتطبيقك بالتعبير عن إمكاناته المطلوبة لـ Google. من خلال الإعلان عن الإمكانات في ملف short.xml وربط معلَمات الأهداف بعملية التنفيذ، تتيح لمساعد Google تشغيل تطبيقك على شاشة محدّدة استجابةً لطلب بحث، ما يتيح للمستخدم إكمال مهمة.

يتم تجميع الأهداف المضمّنة وفقًا لفئات التطبيقات. تمثل كل فئة مجموعة من المهام الشائعة التي يريد المستخدمون إجراؤها بشكل متكرر على تطبيقاتهم. تتوفّر القائمة الكاملة لمعرّفات BII المتاحة ومَعلماتها ونماذج طلبات البحث القابلة للاستخدام للاختبار في مرجع الغرض المضمَّن.

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

الشكل 1. يمكنك استدعاء START_EXERCISE BII من خلال طلب صوتي إلى "مساعد Google".
الشكل 2. افتح التطبيق على شاشة محدّدة لبدء مهمة START_EXERCISE.
الشكل 3. عرض أداة استجابةً لطلب بحث

​

تنفيذ معرّفات BII والتعامل مع مَعلمات الأهداف

بالنسبة إلى "مهامّ في التطبيقات"، عليك توضيح الإمكانات والتعامل مع مَعلمات BII في ملف short.xml. لتنفيذ BII والتعامل مع معاملاته، اتبع الخطوات التالية:

  1. يمكنك تعريف capability باستخدام العنصر BII الذي تم اختياره.
  2. أضِف عناصر parameter مدمجة لكل حقل BII تريد إضافته.
    1. إذا استخدمت targetClass أو targetPackage، اربطهما بطلب Android extras باستخدام اسم من اختيارك.
    2. إذا كنت تستخدِم عنوان URL لرابط صفحة معيّنة في التطبيق، استخدِم المَعلمات المُسمّاة في سلسلة طلب البحث لنموذج عنوان URL.

للتعامل مع مَعلمة BII، اربط المَعلمة BII بالمَعلمة المقابلة لهدف Android صريح في capability. بعد ذلك، يمكنك استخدام قيمته في تطبيقك، ولكن لا يُشترَط على تطبيقك التعامل مع مَعلمات BII. ومع ذلك، حاول معالجة حقول البيانات التي تم وضع علامة "مقترَحة" عليها في مرجع الغرض المضمَّن.

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

على سبيل المثال، يقترح هدف actions.intent.START_EXERCISE أن يتعامل تطبيقك مع معلَمة exercise.name BII، ولكن يمكنك تنفيذ BII في تطبيقك بدون أي معلَمات. يمكنك القيام بذلك إذا كنت تريد التعامل مع طلبات بحث المستخدمين بدون اسم التمرين المحدد، مثل "اطلب من تطبيق Example بدء تتبع التمرين".

يحتوي المقتطف التالي على إجراء احتياطي لعملية تنفيذ بدون معلمات مطلوبة في حال عدم تضمين المعلمات في طلب بحث المستخدم:

<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">

    <capability android:name="actions.intent.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity1"
            android:targetPackage="com.example.myapplication">
            <parameter
                android:name="exercise.name"
                android:key="exerciseType"
                android:required="true"
                />
        </intent>
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity2">
        </intent>
    </capability>
</shortcuts>

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

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

التوضيح

قد لا تحدِّد الوسيطات التي يتم تمريرها إلى تطبيقك عبر <url-parameter> أو الإضافات المستندة إلى النية بشكل فريد العنصر الذي تريد عرضه للمستخدم. في هذه الحالة، استخدِم قيمة الوسيطة كوسيطة بحث وانقل المستخدم إلى صفحة البحث في التطبيق. ويمكنها إزالة الغموض واختيار العنصر المناسب.

على سبيل المثال، إذا كان طلب بحث المستخدم هو "الطلب من مطعم كبير" لـ ORDER_MENU_ITEM BII، يمكنك أن تقدّم للمستخدم قائمة بالمطاعم التي تتطابق أسماؤها مع العبارة "Example Restaurant".

دعم اللغة

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