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

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

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

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

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

2. أدرِج المعلومات المطلوبة التالية في الإمكانية:

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

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

   • عمليات ربط المَعلمات: قد يحتوي كل intent على مَعلمات يتم تمريرها كبيانات extra للغرض.

يوضّح المثال التالي تعريفًا لإحدى الإمكانات في 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>
shortcuts_capability.xml

في المثال السابق، تشير السمة <capability> android:name إلى الهدف المتضمّن في التطبيق START_EXERCISE. إذا طلب المستخدم من "مساعد Google" تنفيذ هذا الغرض المضمّن في التطبيق من خلال قول "Ok 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.