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

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

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

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

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

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

بالنسبة إلى "إجراءات التطبيق"، يجب الإفصاح عن الإمكانات والتعامل مع معلَمات BII في ملف shortcuts.xml. لتنفيذ BII والتعامل مع معلماته، اتّبِع الخطوات التالية:

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

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

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

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

يتضمّن المقتطف التالي عنصرًا احتياطيًا لتنفيذ عملية تنفيذ بدون أي معلَمات مطلوبة إذا لم يتم تضمين المعلَمات في طلب بحث المستخدم:

<?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" قصارى جهده لتقديم المعلومات الأكثر صلة بالمستخدمين عند عرض قيم المَعلمات إلى تطبيقك. على سبيل المثال، لا تتضمّن دائمًا طلبات البحث التي يُدخلها المستخدمون لطلب البيتزا من تطبيق "المطعم" المتوافق مع الأجهزة الجوّالة موقعًا جغرافيًّا. لتقديم خدمة أفضل للمستخدم، قد يقدّم "مساعد Google" قيم خطوط الطول والعرض لأقرب مطعم مثالي لهذا التطبيق.

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

التوضيح

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

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

دعم اللغة

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