إضافة إمكانات إلى الاختصارات

تتيح لك الإمكانات في shortcuts.xml الإفصاح عن أنواع الإجراءات التي يمكن للمستخدمين اتّخاذها لتشغيل تطبيقك وتنفيذ مهمة معيّنة مباشرةً.

على سبيل المثال، تستخدم "إجراءات التطبيقات" في "مساعد Google" إمكانات للسماح للمطوّرين بتوسيع نطاق الميزات داخل التطبيق لتشمل المهام المضمّنة (BIIs)، ما يتيح للمستخدمين تفعيل تلك الميزات والتحكّم فيها باستخدام الطلبات الصوتية. تتألف الإمكانية من اسم الإجراء وintent يستهدف الوجهة في تطبيقك ويؤدي إلى حلّ نية المستخدِم.

تحديد الإمكانات في Short.xml

يمكنك تحديد عناصر capability في ملف موارد shortcuts.xml في مشروع تطوير تطبيق Android. لتحديد عنصر capability، اتّبِع الخطوات التالية:

1. أنشئ موردًا من النوع shortcuts.xml باتّباع التعليمات الواردة في مقالة إنشاء اختصارات ثابتة.

2. يُرجى تضمين المعلومات المطلوبة التالية في نموذج معلومات القدرات:

   • اسم الميزة: الإجراء الذي تريد أن يتيحه تطبيقك. راجِع مستندات المكوّنات للميزة التي تتطلّب تعريفات قدرات. تستخدم الطلبات الصوتية لميزة "إجراءات التطبيقات" معيار BII Action ID لأسماء الإمكانات، والتي يمكنك العثور عليها في مرجع BII. على سبيل المثال، يُدرج GET_THING BII Action ID على أنّه actions.intent.GET_THING.

   • وجهة التطبيق: هي الوجهة في تطبيقك التي يتم إطلاق الإجراء من أجلها لإكمال طلب المستخدم. حدِّد وجهات التطبيق باستخدام عناصر intent مُدمجة في capability.

   • عمليات ربط المَعلمات: قد يحتوي كلّ intent على مَعلمات ليتمّ تمريرها كبيانات extra للنية. على سبيل المثال، يحتوي كل نموذج معلومات متقدّمة عن المستخدمين (BII) لإجراءات التطبيقات على حقول تمثّل المعلومات التي يقدّمها المستخدمون غالبًا في طلبات البحث التي تؤدي إلى تنشيط نموذج المعلومات المتقدّمة عن المستخدمين (BII).

يوضِّح المثال التالي تعريفًا للقدرة في shortcuts.xml لتطبيق actions.intent.START_EXERCISE، وهو واجهة مستخدم تفاعلية تتيح للمستخدمين استخدام تعليمات ملفتة باستخدام "مساعد Google" لبدء تمرين في تطبيق لياقة بدنية:

<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:targetPackage="com.example.sampleApp"
      android:targetClass="com.example.sampleApp.ExerciseActivity">
      <parameter
        android:name="exercise.name"
        android:key="exerciseType"/>
    </intent>
  </capability>
</shortcuts>

في المثال السابق، تشير سمة <capability> android:name إلى رقم تعريف BII الخاص بالجهة START_EXERCISE. إذا طلب المستخدم من "مساعد Google" " مرحبًا Google، أريد بدء تشغيل في ExampleApp"، سينفّذ "مساعد Google" طلب المستخدم باستخدام المعلومات المقدَّمة في عنصر intent المُدمَج. يحدد العنصر intent في هذا النموذج التفاصيل التالية:

• ويحدِّد android:targetPackage حزمة التطبيق المستهدَفة لهذه النية.
• يحدِّد الحقل android:targetClass النشاط الوجهة: com.example.sampleApp.ExerciseActivity.
• يعلن الغرض parameter عن توفّر مَعلمة BII exercise.name وكيفية تمرير قيمة المَعلمة التي يتم جمعها من المستخدِم كبيانات إضافية في intent.

ربط الاختصارات بإحدى الميزات

بعد تحديد إحدى الإمكانات، يمكنك توسيع وظائفها من خلال ربط اختصارات ثابتة أو ديناميكية بها. وتعتمد كيفية ربط الاختصارات بـ capability على الميزة التي يتم تنفيذها والكلمات الفعلية المضمّنة في طلب المستخدم. على سبيل المثال، عندما يبدأ المستخدم الجري في تطبيق "تتبُّع اللياقة البدنية" من خلال توجيه طلب إلى "مساعد Google": "Ok Google، أريد بدء تمرين جري في ExampleApp". يمكن أن يستخدم "مساعد Google" اختصارًا لبدء مثيل من capability يحدِّد عنصر تمرين شرعيًا من "الجري" للمَعلمة exercise.name.

لمزيد من المعلومات عن ربط الاختصارات بإجراءات التطبيقات، يُرجى الاطّلاع على نظرة عامة على "مهامّ في التطبيقات".