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

إنّ الأغراض المضمّنة (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 طريقة التنفيذ المناسبة استنادًا إلى مَعلمات الإمكانيات التي يعرّفها من خلال طلب بحث المستخدم والمَعلمات التي تم تعريفها في نية شراء.

على سبيل المثال، في actions.intent.START_EXERCISE يقترح intent أن يتعامل تطبيقك مع معلَمة 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> أو الإضافات المستندة إلى النية. تحدد بشكل فريد العنصر الذي تريد عرضه للمستخدم. وفي هذه الحالة، استخدام قيمة الوسيطة كوسيطة بحث ونقل المستخدم إلى نافذة البحث من التطبيق. يمكنه التمييز بين العنصر الصحيح واختيار العنصر المناسب.

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

دعم اللغة

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